db2 para linux,unix ywindowspublic.dhe.ibm.com/ps/products/db2/info/vr97/pdf/... · db2 para...
TRANSCRIPT
-
DB2para Linux, UNIX y Windows
Rutinas y vistas administrativasActualizado en julio de 2012
Versión 9 Release 7
SC11-3909-03
���
-
DB2para Linux, UNIX y Windows
Rutinas y vistas administrativasActualizado en julio de 2012
Versión 9 Release 7
SC11-3909-03
���
-
NotaAntes de utilizar esta información y el producto al que da soporte, lea la información general contenida en el apartadoApéndice B, “Avisos”, en la página 1405.
Nota de edición
Este manual es la traducción del original en inglés DB2 for Linux, UNIX, and Windows Version 9 Release 7Administrative Routines and Views Updated July, 2012 (SC27-2436-03).
Este documento contiene información propiedad de IBM. Se proporciona según un acuerdo de licencia y estáprotegido por la ley de la propiedad intelectual. La información contenida en esta publicación no incluye ningunagarantía de producto, por lo que ninguna declaración proporcionada en este manual deberá interpretarse como tal.
Puede realizar pedidos de publicaciones de IBM en línea o a través del representante de IBM de su localidad.v Para realizar pedidos en línea, vaya a IBM Publications Center ubicado en el sitio web www.ibm.com/shop/
publications/order
v Para encontrar al representante de IBM de su localidad, vaya al IBM Directory of Worldwide Contacts en el sitioweb www.ibm.com/planetwide
Para realizar pedidos de publicaciones de DB2 desde DB2 Marketing and Sales, en los EE.UU. o en Canadá, llameal 1-800-IBM-4YOU (426-4968).
Cuando envía información a IBM, otorga a IBM un derecho no exclusivo a utilizar o distribuir dicha información enla forma en que IBM considere adecuada, sin contraer por ello ninguna obligación con el remitente.
© Copyright IBM Corporation 2006, 2012.
-
Contenido
Capítulo 1. Vistas y rutinas definidas porel sistema . . . . . . . . . . . . . . 1Recomendaciones para llamar a rutinas y vistasincorporadas en aplicaciones . . . . . . . . . 1Autorización para vistas administrativas . . . . . 2Vistas administrativas comparadas con funciones detablas . . . . . . . . . . . . . . . . . 3
Capítulo 2. Rutinas y vistas de SQLdefinidas por el sistema soportadas . . 5
Capítulo 3. Rutinas del supervisor deactividades . . . . . . . . . . . . . 23AM_BASE_RPT_RECOMS – Recomendaciones parainformes de actividad . . . . . . . . . . . 23AM_BASE_RPTS – Informes del supervisor deactividad . . . . . . . . . . . . . . . 24RAM_DROP_TASK – Supresión de una tarea desupervisión . . . . . . . . . . . . . . 25RAM_GET_LOCK_CHN_TB – Recuperación de losdatos de la cadena de bloqueo de la aplicación enformato tabular . . . . . . . . . . . . . 26RAM_GET_LOCK_CHNS – Recuperación deinformación de bloqueo de cadenas para unaaplicación específica . . . . . . . . . . . 27RAM_GET_LOCK_RPT – Recuperación de losdetalles del bloqueo de la aplicación . . . . . . 27RAM_GET_RPT – Recuperación de datos delsupervisor de actividad . . . . . . . . . . 35RAM_SAVE_TASK – Creación o modificación deuna tarea de supervisión . . . . . . . . . . 36
Capítulo 4. Procedimiento ADMIN_CMDy rutinas asociadas . . . . . . . . . 39ADMIN_CMD – Ejecutar mandatos administrativos 39
Mandato ADD CONTACT utilizando elprocedimiento ADMIN_CMD . . . . . . . 41Mandato ADD CONTACTGROUP utilizando elprocedimiento ADMIN_CMD . . . . . . . 43Mandato AUTOCONFIGURE utilizando elprocedimiento ADMIN_CMD . . . . . . . 44Mandato BACKUP DATABASE utilizando elprocedimiento ADMIN_CMD . . . . . . . 48Mandato DESCRIBE utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 57Mandato DROP CONTACT utilizando elprocedimiento ADMIN_CMD . . . . . . . 71Mandato DROP CONTACTGROUP utilizando elprocedimiento ADMIN_CMD . . . . . . . 72Mandato EXPORT utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 73Mandato FORCE APPLICATION utilizando elprocedimiento ADMIN_CMD . . . . . . . 85
Mandato GET STMM TUNINGDBPARTITIONNUM mediante el procedimientoADMIN_CMD . . . . . . . . . . . . 86Mandato IMPORT utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 88Mandato INITIALIZE TAPE utilizando elprocedimiento ADMIN_CMD . . . . . . . 116Mandato LOAD utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 117Mandato PRUNE HISTORY/LOGFILEutilizando el procedimiento ADMIN_CMD . . 161Mandato QUIESCE DATABASE utilizando elprocedimiento ADMIN_CMD . . . . . . . 163Mandato QUIESCE TABLESPACES FOR TABLEutilizando el procedimiento ADMIN_CMD . . 165Mandato REDISTRIBUTE DATABASEPARTITION GROUP utilizando elprocedimiento ADMIN_CMD . . . . . . . 168Mandato REORG INDEXES/TABLE utilizandoel procedimiento ADMIN_CMD . . . . . . 178Mandato RESET ALERT CONFIGURATIONutilizando el procedimiento ADMIN_CMD . . 195Mandato RESET DATABASECONFIGURATION utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 197Mandato RESET DATABASE MANAGERCONFIGURATION utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 198Mandato REWIND TAPE utilizando elprocedimiento ADMIN_CMD . . . . . . . 200Mandato RUNSTATS utilizando elprocedimiento ADMIN_CMD . . . . . . . 200Mandato SET TAPE POSITION utilizando elprocedimiento ADMIN_CMD . . . . . . . 214Mandato UNQUIESCE DATABASE utilizando elprocedimiento ADMIN_CMD . . . . . . . 215Mandato UPDATE ALERT CONFIGURATIONutilizando el procedimiento ADMIN_CMD . . 216Mandato UPDATE CONTACT utilizando elprocedimiento ADMIN_CMD . . . . . . . 221Mandato UPDATE CONTACTGROUPutilizando el procedimiento ADMIN_CMD . . 222Mandato UPDATE DATABASECONFIGURATION utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 224Mandato UPDATE DATABASE MANAGERCONFIGURATION utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 227Mandato UPDATE HEALTH NOTIFICATIONCONTACT LIST utilizando el procedimientoADMIN_CMD . . . . . . . . . . . . 229Mandato UPDATE HISTORY utilizando elprocedimiento ADMIN_CMD . . . . . . . 230Mandato UPDATE STMM TUNINGDBPARTITIONNUM mediante el procedimientoADMIN_CMD . . . . . . . . . . . . 232
© Copyright IBM Corp. 2006, 2012 iii
-
Función ADMIN_EST_INLINE_LENGTH - Estimarla longitud necesaria en datos en línea . . . . . 233Función de tablaADMIN_GET_DBP_MEM_USAGE - Obtener elconsumo de memoria total por instancia . . . . 235Función de tablaADMIN_GET_INDEX_COMPRESS_INFO -Devolver información de índice de compresión . . 237Función de tabla ADMIN_GET_INDEX_INFO -Devolver información de índice . . . . . . . 241Función de tabla ADMIN_GET_MSGS - Recuperarmensajes generados por un programa de utilidadde movimiento de datos que utiliza elprocedimiento ADMIN_CMD . . . . . . . . 245Función ADMIN_IS_INLINED - Determinar si losdatos están en línea . . . . . . . . . . . 247Procedimiento ADMIN_REMOVE_MSGS - Limpiarlos mensajes que genera un programa de utilidadde movimiento de datos que utiliza elprocedimiento ADMIN_CMD . . . . . . . . 248ProcedimientoADMIN_REVALIDATE_DB_OBJECTS - Revalidarobjetos de base de datos no válidos . . . . . . 249Vista administrativa ADMINTABCOMPRESSINFOy función de tablaADMIN_GET_TAB_COMPRESS_INFO_V97 -Devolver información de compresión . . . . . 251Vista administrativa ADMINTABINFO y funciónde tabla ADMIN_GET_TAB_INFO_V97 –Recuperar información de tamaño y estado . . . 259Vista administrativa ADMINTEMPCOLUMNS yfunción de tabla ADMIN_GET_TEMP_COLUMNS- Recuperar información de columna para tablastemporales . . . . . . . . . . . . . . 268Vista administrativa ADMINTEMPTABLES yfunción de tabla ADMIN_GET_TEMP_TABLES -Recuperar información para tablas temporales . . 272
Capítulo 5. Vistas y rutinas delplanificador de tareas administrativas. 277Procedimiento ADMIN_TASK_ADD - Planificaruna nueva tarea . . . . . . . . . . . . 277
Formato cron de UNIX . . . . . . . . . 280Vista administrativa ADMIN_TASK_LIST -Recuperar información sobre las tareas en elplanificador . . . . . . . . . . . . . . 282Procedimiento ADMIN_TASK_REMOVE - Eliminarregistros de tareas planificadas o de estados detareas . . . . . . . . . . . . . . . . 284Vista administrativa ADMIN_TASK_STATUS -Recuperar información de estado de tarea . . . . 285Procedimiento ADMIN_TASK_UPDATE -Actualizar una tarea existente . . . . . . . . 287
Capítulo 6. Rutinas y procedimientosde auditoría . . . . . . . . . . . . 291Procedimiento y función de tablaAUDIT_ARCHIVE - Archivar archivo deanotaciones cronológicas de auditoría . . . . . 291
AUDIT_DELIM_EXTRACT - Realizar extracción enarchivo delimitado . . . . . . . . . . . 292Función de tabla AUDIT_LIST_LOGS - Enumeralos archivos de anotaciones cronológicas deauditoría archivados . . . . . . . . . . . 293
Capítulo 7. Rutinas de mantenimientoautomático . . . . . . . . . . . . 295Procedimiento AUTOMAINT_GET_POLICY -recuperar la política de mantenimiento automático . 295Procedimiento AUTOMAINT_GET_POLICYFILE -recuperar la política de mantenimiento automático . 296Procedimiento AUTOMAINT_SET_POLICY -Configurar política de mantenimiento automático . 297Procedimiento AUTOMAINT_SET_POLICYFILE -configurar la política de mantenimiento automático 298
Capítulo 8. Procedimientos de la APIde SQL común . . . . . . . . . . . 301Parámetros de entrada y salida comunes . . . . 301Creación de versiones de documentos XML . . . 302Documentos de entrada XML . . . . . . . . 303
Modalidad completa para la devolución dedocumentos de entrada XML válidos . . . . 304
Documentos de salida XML . . . . . . . . 304Expresiones XPath para el filtrado de salidas 305
Documentos de mensaje XML . . . . . . . . 306Procedimiento CANCEL_WORK - Cancelar trabajo 307DESIGN_ADVISOR - recuperar lasrecomendaciones del asesor de diseño . . . . . 313Procedimiento GET_CONFIG - Obtener datos deconfiguración . . . . . . . . . . . . . 321Procedimiento GET_MESSAGE - Obtener texto demensaje . . . . . . . . . . . . . . . 327Procedimiento GET_SYSTEM_INFO - Obtenerinformación de sistema . . . . . . . . . . 334Procedimiento SET_CONFIG - Establecerparámetros de configuración . . . . . . . . 340
Capítulo 9. Rutinas y vistas deconfiguración . . . . . . . . . . . 351DB_PARTITIONS . . . . . . . . . . . . 351Vista administrativa DBCFG - Recuperarinformación sobre los parámetros de configuraciónde la base de datos . . . . . . . . . . . 352Vista administrativa DBMCFG - Recuperarinformación sobre los parámetros de configuracióndel gestor de bases de datos . . . . . . . . 354Vista administrativa REG_VARIABLES - Recuperarvalores de registro de DB2 en uso . . . . . . 357
Capítulo 10. Vistas del entorno . . . . 359Vista administrativa ENV_FEATURE_INFO -Devolver información de licencia para lascaracterísticas de DB2 . . . . . . . . . . 359Función de tablaENV_GET_DB2_SYSTEM_RESOURCES - Devolverinformación de sistema de DB2 . . . . . . . 360
iv Rutinas y vistas administrativas
-
Función de tablaENV_GET_NETWORK_RESOURCES - Devolverinformación de red . . . . . . . . . . . 361Función de tabla ENV_GET_SYSTEM_RESOURCES- Devolver información de sistema . . . . . . 363Vista administrativa ENV_INST_INFO - Recuperarinformación sobre la instancia actual . . . . . 365Vista administrativa ENV_PROD_INFO -Recuperar información sobre productos DB2instalados . . . . . . . . . . . . . . 366Vista administrativa ENV_SYS_INFO – Recuperarinformación sobre el sistema . . . . . . . . 368
Capítulo 11. Rutinas de Explain . . . 369EXPLAIN_GET_MSGS . . . . . . . . . . 369EXPLAIN_FORMAT_STATS . . . . . . . . 371Procedimiento EXPLAIN_FROM_ACTIVITY -Sentencia de Explain que utiliza información desupervisor de sucesos de actividad . . . . . . 376Procedimiento EXPLAIN_FROM_CATALOG -Explicar una sentencia mediante la utilización de lainformación de sección de los catálogos . . . . 379Procedimiento EXPLAIN_FROM_DATA - Explicaruna sentencia mediante la utilización de la secciónde entrada . . . . . . . . . . . . . . 381Procedimiento EXPLAIN_FROM_SECTION -Explicar una sentencia mediante la utilización de lainformación de la antememoria de paquete o delsupervisor de sucesos de antememoria de paquete . 384
Capítulo 12. Rutinas y vistas desupervisor. . . . . . . . . . . . . 389ProcedimientoEVMON_FORMAT_UE_TO_TABLES - Trasladar undocumento XML a tablas relacionales . . . . . 391Función de tabla EVMON_FORMAT_UE_TO_XML- Convertir sucesos sin formatear a XML . . . . 400MON_BP_UTILIZATION - Recuperar métricaspara agrupaciones de almacenamientosintermedios . . . . . . . . . . . . . . 404MON_CONNECTION_SUMMARY - Recuperarmétricas para todas las conexiones . . . . . . 411MON_CURRENT_SQL - Recuperar métricas clavepara todas las actividades de todos los miembros . 415MON_CURRENT_UOW - Recuperar métricas paratodas las unidades de trabajo . . . . . . . . 417MON_DB_SUMMARY - Recuperar métricasacumuladas de todos los miembros de la base dedatos . . . . . . . . . . . . . . . . 419MON_FORMAT_LOCK_NAME - Formatear elnombre de bloqueo interno y devolver detalles . . 423MON_FORMAT_XML_COMPONENT_TIMES_BY_ROW - Obtener tiempos decomponente basados en filas formateados . . . . 426MON_FORMAT_XML_METRICS_BY_ROW -Obtener salida basada en filas formateada paratodas las métricas . . . . . . . . . . . . 430MON_FORMAT_XML_TIMES_BY_ROW - Obtenertiempos de espera y proceso de jerarquíacombinados basados en filas formateados . . . . 439
MON_FORMAT_XML_WAIT_TIMES_BY_ROW -Obtener salida formateada basada en filas para lostiempos de espera . . . . . . . . . . . . 445Función de tabla MON_GET_ACTIVITY_DETAILS- Obtener detalles completos sobre la actividad . . 449MON_GET_APPL_LOCKWAIT - Obtenerinformación acerca de los bloqueos para los queexiste una aplicación en espera . . . . . . . 460Función de tabla MON_GET_BUFFERPOOL -Obtener métrica de agrupación dealmacenamientos intermedios . . . . . . . . 465Función de tabla MON_GET_CONNECTION -Obtener métrica de conexión . . . . . . . . 469Función de tablaMON_GET_CONNECTION_DETAILS - Obtenermétrica de conexión detallada . . . . . . . . 476Función de tabla MON_GET_CONTAINER -Obtener métrica del contenedor de espacio detablas . . . . . . . . . . . . . . . . 484MON_GET_EXTENT_MOVEMENT_STATUS -obtener el progreso del traslado de extensiones . . 487MON_GET_FCM - Obtener métricas FCM. . . . 489MON_GET_FCM_CONNECTION_LIST - Obtenerdetalles para todas las conexiones FCM . . . . 490Función de tabla MON_GET_INDEX - Obtenermétrica de índice . . . . . . . . . . . . 491MON_GET_LOCKS - Listar todos los bloqueos dela base de datos actualmente conectada. . . . . 494MON_GET_MEMORY_POOL - Obtenerinformación de la agrupación de memoria. . . . 500MON_GET_MEMORY_SET - Obtener informacióndel conjunto de memoria . . . . . . . . . 502Función de tabla MON_GET_PKG_CACHE_STMT- Obtener métrica de actividad de sentencia deSQL en la antememoria de paquetes. . . . . . 504MON_GET_PKG_CACHE_STMT_DETAILS -Obtener métricas detalladas para las entradas deantememoria de paquete . . . . . . . . . 511Función de tabla MON_GET_SERVICE_SUBCLASS- Obtener métrica de subclase de servicio . . . . 519Función de tablaMON_GET_SERVICE_SUBCLASS_DETAILS -Obtener métrica detallada de subclase de servicio . 527Función de tabla MON_GET_TABLE - Obtenermétrica de tabla . . . . . . . . . . . . 535Función de tabla MON_GET_TABLESPACE -Obtener métrica de espacio de tablas . . . . . 538Función de tabla MON_GET_UNIT_OF_WORK -Obtener métrica de unidad de trabajo . . . . . 544Función de tablaMON_GET_UNIT_OF_WORK_DETAILS - Obtenermétrica detallada de unidad de trabajo . . . . . 550Función de tabla MON_GET_WORKLOAD -Obtener métrica de carga de trabajo . . . . . . 560Función de tablaMON_GET_WORKLOAD_DETAILS - Obtenermétrica detallada de carga de trabajo . . . . . 566Vista administrativa MON_LOCKWAITS -Recuperar la métrica de las aplicaciones que estána la espera de obtener bloqueos . . . . . . . 574
Contenido v
-
MON_PKG_CACHE_SUMMARY - Recuperar unresumen de alto nivel de la antememoria depaquete de la base de datos . . . . . . . . 577MON_SERVICE_SUBCLASS_SUMMARY -Recuperar métricas para todas las subclases deservicios . . . . . . . . . . . . . . . 579MON_TBSP_UTILIZATION - Recuperar métricasde supervisión para todos los espacios de tablas ytodas las particiones de base de datos . . . . . 583MON_WORKLOAD_SUMMARY - Recuperamétricas para todas las cargas de trabajo . . . . 587
Capítulo 13. Rutinas de MQSeries . . 593MQPUBLISH . . . . . . . . . . . . . 593MQREAD . . . . . . . . . . . . . . 595MQREADALL . . . . . . . . . . . . . 596MQREADALLCLOB . . . . . . . . . . . 598MQREADCLOB . . . . . . . . . . . . 600MQRECEIVE . . . . . . . . . . . . . 601MQRECEIVEALL . . . . . . . . . . . . 603MQRECEIVEALLCLOB . . . . . . . . . . 605MQRECEIVECLOB . . . . . . . . . . . 607MQSEND . . . . . . . . . . . . . . 609MQSUBSCRIBE . . . . . . . . . . . . 610MQUNSUBSCRIBE . . . . . . . . . . . 612
Capítulo 14. Rutinas y vistas deseguridad . . . . . . . . . . . . . 615AUTH_GET_INSTANCE_AUTHID - Obtener el IDde autorización de propietario de instancia . . . 615AUTH_LIST_AUTHORITIES_FOR_AUTHID . . . 616Función de tablaAUTH_LIST_GROUPS_FOR_AUTHID –Recuperación lista de pertenencia al grupo para unID de autorización determinado . . . . . . . 620Función AUTH_LIST_ROLES_FOR_AUTHID -Devuelve la lista de roles . . . . . . . . . 621Vista administrativa AUTHORIZATIONIDS –Recuperar ID y tipos de autorización . . . . . 623Vista administrativa OBJECTOWNERS – Recuperarinformación sobre propiedad de objetos . . . . 624Vista administrativa PRIVILEGES – Recuperarinformación sobre privilegios . . . . . . . . 625
Capítulo 15. Rutinas y vistas deinstantáneas. . . . . . . . . . . . 629Vista administrativa APPL_PERFORMANCE –Recuperar porcentaje de filas seleccionadas parauna aplicación . . . . . . . . . . . . . 629Vista administrativa APPLICATIONS - Recuperarinformación de aplicación de base de datosconectada . . . . . . . . . . . . . . 630Vista administrativa BP_HITRATIO – Recuperarinformación sobre la tasa de aciertos de agrupaciónde almacenamientos intermedios . . . . . . . 634Vista administrativa BP_READ_IO – Recuperarinformación de rendimiento de lectura de lasagrupaciones de almacenamientos intermedios . . 637
Vista administrativa BP_WRITE_IO – Recuperarinformación de rendimiento de grabación de lasagrupaciones de almacenamientos intermedios . . 639Vista administrativa CONTAINER_UTILIZATION -Recuperar información de utilización y contenedorde espacio de tablas . . . . . . . . . . . 641Vista administrativa LOCKS_HELD – Recuperarinformación acerca de los bloqueos retenidos . . . 643Vista administrativa LOCKWAITS – Recuperarinformación de bloqueos actuales en espera de seractivados . . . . . . . . . . . . . . . 646Vista administrativa LOG_UTILIZATION –Recuperar información de utilización de lasanotaciones cronológicas . . . . . . . . . 650Vista administrativa LONG_RUNNING_SQL. . . 651Vista administrativa QUERY_PREP_COST –Recuperar información de tiempo de preparaciónde sentencias . . . . . . . . . . . . . 654Vista administrativa SNAPAGENT y función detabla SNAP_GET_AGENT – Recuperar informaciónde instantáneas de la aplicación del grupo de datoslógicos agent . . . . . . . . . . . . . 655Vista administrativa SNAPAPPL_INFO y funciónde tabla SNAP_GET_APPL_INFO_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos appl_info . . . . . . . . . . . . 659Vista administrativa SNAPAPPL y función de tablaSNAP_GET_APPL_V95 – Recuperar informaciónde instantáneas del grupo de datos lógicos appl . . 666Vista administrativa SNAPBP y función de tablaSNAP_GET_BP_V95 – Recuperar información deinstantáneas del grupo lógico bufferpool . . . . 676Vista administrativa SNAPBP_PART y función detabla SNAP_GET_BP_PART – Recuperarinformación de instantáneas del grupo de datoslógicos bufferpool_nodeinfo . . . . . . . . 682Vista administrativa SNAPCONTAINER y funciónde tabla SNAP_GET_CONTAINER_V91 –Recuperar información acerca de la instantánea degrupo de datos lógicos tablespace_container . . . 686Vista administrativa SNAPDB y función de tablaSNAP_GET_DB_V97 – Recuperar información deinstantánea desde el grupo lógico dbase . . . . 690Vista administrativa SNAPDBM y función de tablaSNAP_GET_DBM_V95 – Recuperar la informaciónde instantáneas del grupo de datos lógicos dbm. . 704Vista administrativa SNAPDETAILLOG y funciónde tabla SNAP_GET_DETAILLOG_V91 - Recuperarinformación de instantánea del grupo de datoslógicos detail_log . . . . . . . . . . . . 708Vista administrativa SNAPDYN_SQL y función detabla SNAP_GET_DYN_SQL_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos dynsql . . . . . . . . . . . . . 712Vista administrativa SNAPFCM y función de tablaSNAP_GET_FCM – Recuperar la información deinstantáneas del grupo de datos lógicos fcm . . . 718Vista administrativa SNAPFCM_PART y funciónde tabla SNAP_GET_FCM_PART – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm_node . . . . . . . . . . . . 720
vi Rutinas y vistas administrativas
-
Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR – Recuperar informaciónde instantáneas del grupo de datos lógicos hadr. . 723Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK – Recuperar informaciónde instantáneas del grupo de datos lógicos lock . . 728Vista administrativa SNAPLOCKWAIT y funciónde tabla SNAP_GET_LOCKWAIT – Recuperarinformación de instantáneas del grupo de datoslógicos lockwait . . . . . . . . . . . . 733Vista administrativa SNAPSTMT y función de tablaSNAP_GET_STMT – Recuperar información deinstantáneas de sentencias . . . . . . . . . 740Vista administrativa SNAPSTORAGE_PATHS yfunción de tablaSNAP_GET_STORAGE_PATHS_V97 - Recuperarinformación de vía de acceso de almacenamientoautomático . . . . . . . . . . . . . . 747Vista administrativa SNAPSUBSECTION y funciónde tabla SNAP_GET_SUBSECTION – Recuperarinformación de instantáneas del grupo desupervisor lógico de la subsección . . . . . . 750Vista administrativa SNAPSWITCHES y función detabla SNAP_GET_SWITCHES - Recuperarinformación de estado de conmutador deinstantáneas de base de datos . . . . . . . . 754Vista administrativa SNAPTAB y función de tablaSNAP_GET_TAB_V91 – Recuperar información deinstantáneas del grupo de datos lógicos table. . . 758Vista administrativa SNAPTAB_REORG y funciónde tabla SNAP_GET_TAB_REORG - Recuperarinformación sobre instantáneas de reorganizaciónde tabla . . . . . . . . . . . . . . . 762Vista administrativa SNAPTBSP y función de tablaSNAP_GET_TBSP_V91 – Recuperar información deinstantáneas del grupo de datos lógicos de espaciode tablas . . . . . . . . . . . . . . . 767Vista administrativa SNAPTBSP_PART y funciónde tabla SNAP_GET_TBSP_PART_V97 – Recuperarinformación de instantáneas del grupo de datoslógicos tablespace_nodeinfo . . . . . . . . 774Vista administrativa SNAPTBSP_QUIESCER yfunción de tabla SNAP_GET_TBSP_QUIESCER –Recuperar información acerca de la instantánea deespacio de tablas de inmovilizador . . . . . . 779Vista administrativa SNAPTBSP_RANGE y funciónde tabla SNAP_GET_TBSP_RANGE – Recuperarinformación acerca de la instantánea de rango . . 783Vista administrativa SNAPUTIL y función de tablaSNAP_GET_UTIL - Recuperar información deinstantánea de grupo de datos lógicos utility_info . 787Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_GET_UTIL_PROGRESS -Recuperar información de instantánea de grupo dedatos lógicos de progreso . . . . . . . . . 791Procedimiento SNAP_WRITE_FILE . . . . . . 795Vista administrativa SNAPAGENT y función detabla SNAP_GET_AGENT – Recuperar informaciónde instantáneas de la aplicación del grupo de datoslógicos agent . . . . . . . . . . . . . 796
Vista administrativaSNAPAGENT_MEMORY_POOL y función de tablaSNAP_GET_AGENT_MEMORY_POOL –Recuperar información de instantáneas del grupode datos lógicos memory_pool . . . . . . . 799Vista administrativa SNAPAPPL_INFO y funciónde tabla SNAP_GET_APPL_INFO_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos appl_info . . . . . . . . . . . . 804Vista administrativa SNAPAPPL y función de tablaSNAP_GET_APPL_V95 – Recuperar informaciónde instantáneas del grupo de datos lógicos appl . . 811Vista administrativa SNAPBP y función de tablaSNAP_GET_BP_V95 – Recuperar información deinstantáneas del grupo lógico bufferpool . . . . 821Vista administrativa SNAPBP_PART y función detabla SNAP_GET_BP_PART – Recuperarinformación de instantáneas del grupo de datoslógicos bufferpool_nodeinfo . . . . . . . . 827Vista administrativa SNAPCONTAINER y funciónde tabla SNAP_GET_CONTAINER_V91 –Recuperar información acerca de la instantánea degrupo de datos lógicos tablespace_container . . . 831Vista administrativa SNAPDB y función de tablaSNAP_GET_DB_V95 – Recuperar información deinstantánea desde el grupo lógico dbase . . . . 835Vista administrativa SNAPDBM y función de tablaSNAP_GET_DBM_V95 – Recuperar la informaciónde instantáneas del grupo de datos lógicos dbm. . 848Vista administrativa SNAPDETAILLOG y funciónde tabla SNAP_GET_DETAILLOG_V91 - Recuperarinformación de instantánea del grupo de datoslógicos detail_log . . . . . . . . . . . . 853Vista administrativa SNAPDYN_SQL y función detabla SNAP_GET_DYN_SQL_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos dynsql . . . . . . . . . . . . . 857Vista administrativa SNAPFCM y función de tablaSNAP_GET_FCM – Recuperar la información deinstantáneas del grupo de datos lógicos fcm . . . 862Vista administrativa SNAPFCM_PART y funciónde tabla SNAP_GET_FCM_PART – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm_node . . . . . . . . . . . . 865Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR – Recuperar informaciónde instantáneas del grupo de datos lógicos hadr. . 868Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK – Recuperar informaciónde instantáneas del grupo de datos lógicos lock . . 873Vista administrativa SNAPLOCKWAIT y funciónde tabla SNAP_GET_LOCKWAIT – Recuperarinformación de instantáneas del grupo de datoslógicos lockwait . . . . . . . . . . . . 878Vista administrativa SNAPSTMT y función de tablaSNAP_GET_STMT – Recuperar información deinstantáneas de sentencias . . . . . . . . . 885Vista administrativa SNAPSTORAGE_PATHS yfunción de tabla SNAP_GET_STORAGE_PATHS –Recuperar información de vía de acceso delalmacenamiento automático . . . . . . . . 892
Contenido vii
-
Vista administrativa SNAPSUBSECTION y funciónde tabla SNAP_GET_SUBSECTION – Recuperarinformación de instantáneas del grupo desupervisor lógico de la subsección . . . . . . 895Vista administrativa SNAPSWITCHES y función detabla SNAP_GET_SWITCHES - Recuperarinformación de estado de conmutador deinstantáneas de base de datos . . . . . . . . 900Vista administrativa SNAPTAB y función de tablaSNAP_GET_TAB_V91 – Recuperar información deinstantáneas del grupo de datos lógicos table. . . 903Vista administrativa SNAPTAB_REORG y funciónde tabla SNAP_GET_TAB_REORG - Recuperarinformación sobre instantáneas de reorganizaciónde tabla . . . . . . . . . . . . . . . 907Vista administrativa SNAPTBSP y función de tablaSNAP_GET_TBSP_V91 – Recuperar información deinstantáneas del grupo de datos lógicos de espaciode tablas . . . . . . . . . . . . . . . 913Vista administrativa SNAPTBSP_PART y funciónde tabla SNAP_GET_TBSP_PART_V91 – Recuperarinformación de instantáneas del grupo de datoslógicos tablespace_nodeinfo . . . . . . . . 920Vista administrativa SNAPTBSP_QUIESCER yfunción de tabla SNAP_GET_TBSP_QUIESCER –Recuperar información acerca de la instantánea deespacio de tablas de inmovilizador . . . . . . 926Vista administrativa SNAPTBSP_RANGE y funciónde tabla SNAP_GET_TBSP_RANGE – Recuperarinformación acerca de la instantánea de rango . . 930Vista administrativa SNAPUTIL y función de tablaSNAP_GET_UTIL - Recuperar información deinstantánea de grupo de datos lógicos utility_info . 934Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_GET_UTIL_PROGRESS -Recuperar información de instantánea de grupo dedatos lógicos de progreso . . . . . . . . . 938Procedimiento SNAP_WRITE_FILE . . . . . . 942Vista administrativa TBSP_UTILIZATION -Recuperar información de configuración yutilización de espacio de tablas . . . . . . . 943Vista administrativa TOP_DYNAMIC_SQL –Recuperar información acerca de las sentencias deSQL dinámico más frecuentes . . . . . . . . 946
Capítulo 16. Rutinas deprocedimientos de SQL . . . . . . . 949Procedimiento ALTER_ROUTINE_PACKAGE . . 949RGET_ROUTINE_OPTS . . . . . . . . . . 950GET_ROUTINE_SAR . . . . . . . . . . . 950PUT_ROUTINE_SAR . . . . . . . . . . . 951Procedimiento REBIND_ROUTINE_PACKAGE -volver a vincular un paquete . . . . . . . . 953RSET_ROUTINE_OPTS . . . . . . . . . . 955
Capítulo 17. Rutinas de redistribuciónpaso a paso . . . . . . . . . . . . 957Procedimiento ANALYZE_LOG_SPACE -Recuperar información de análisis de espacio deanotaciones . . . . . . . . . . . . . . 957
Procedimiento GENERATE_DISTFILE - Generararchivo de distribución de datos . . . . . . . 959Procedimiento GET_SWRD_SETTINGS - Recuperarinformación de redistribución . . . . . . . . 960Procedimiento SET_SWRD_SETTINGS - Crear ocambiar registro de redistribución . . . . . . 963Procedimiento STEPWISE_REDISTRIBUTE_DBPG -Redistribuir parte del grupo de particiones de basede datos . . . . . . . . . . . . . . . 965
Capítulo 18. Rutinas de la herramientade gestión de almacenamiento . . . . 967Procedimiento CAPTURE_STORAGEMGMT_INFO– Recuperar información relacionada con elalmacenamiento para un objeto raíz concreto . . . 967ProcedimientoCREATE_STORAGEMGMT_TABLES - Crear tablasde gestión de almacenamiento. . . . . . . . 969Procedimiento DROP_STORAGEMGMT_TABLES -Descartar todas las tablas de gestión dealmacenamiento . . . . . . . . . . . . 970
Capítulo 19. Rutinas de búsqueda detexto . . . . . . . . . . . . . . . 971Procedimiento almacenado SYSTS_ADMIN_CMD -Ejecutar mandatos de administración de búsquedade texto . . . . . . . . . . . . . . . 971Procedimiento SYSTS_ALTER - Cambiar lascaracterísticas de actualización de un índice . . . 972Procedimiento SYSTS_CLEAR_COMMANDLOCKS- Eliminar bloqueos de mandato para índices debúsqueda de texto . . . . . . . . . . . . 977Procedimiento SYSTS_CLEAR_EVENTS - Suprimirlos sucesos de indexación de una tabla de sucesosde índice . . . . . . . . . . . . . . . 980Procedimiento SYSTS_CREATE - Crear un índicede búsqueda de texto en una columna . . . . . 982Procedimiento SYSTS_DISABLE - Inhabilitar basede datos actual para búsqueda de textos . . . . 990Procedimiento SYSTS_DROP - Descartar un índicede búsqueda de texto. . . . . . . . . . . 992Procedimiento SYSTS_ENABLE - Habilitar base dedatos actual para búsqueda de texto. . . . . . 995Procedimiento SYSTS_UPDATE - Actualizar elíndice de búsqueda de texto . . . . . . . . 996
Capítulo 20. Rutinas de gestión decargas de trabajo . . . . . . . . . 1001WLM_CANCEL_ACTIVITY - Cancelar unaactividad . . . . . . . . . . . . . . 1001WLM_CAPTURE_ACTIVITY_IN_PROGRESS -Recopilar información para supervisor de sucesosde actividades . . . . . . . . . . . . . 1002WLM_COLLECT_STATS - Coleccionar y restaurarestadísticas de gestión de carga de trabajo . . . 1004WLM_GET_CONN_ENV - Obtener los valores deuna recopilación de datos de actividad para unaconexión . . . . . . . . . . . . . . 1005Función de tabla WLM_GET_QUEUE_STATS -Devolver estadísticas de cola de umbral . . . . 1007
viii Rutinas y vistas administrativas
-
Función de tablaWLM_GET_SERVICE_CLASS_AGENTS_V97 -Listar los agentes que se ejecutan en una clase deservicio . . . . . . . . . . . . . . . 1012WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97 - Listar apariciones decarga de trabajo . . . . . . . . . . . . 1020Función de tablaWLM_GET_SERVICE_SUBCLASS_STATS_V97 -Devolver estadísticas de subclases de servicio . . 1025WLM_GET_SERVICE_SUPERCLASS_STATS -Devolver estadísticas de superclases de servicio . 1035WLM_GET_WORK_ACTION_SET_STATS -Devolver estadísticas de conjunto de acciones detrabajo . . . . . . . . . . . . . . . 1036WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES_V97 - Devolver una lista deactividades . . . . . . . . . . . . . . 1038Función de tablaWLM_GET_WORKLOAD_STATS_V97 - Devolverestadísticas de carga de trabajo . . . . . . . 1044Procedimiento WLM_SET_CLIENT_INFO -Establecer información de cliente . . . . . . 1049WLM_SET_CONN_ENV - Habilitar larecopilación de datos de actividad y la mediciónde datos reales de sección . . . . . . . . . 1051
Capítulo 21. Rutinas y vistas varias 1055Procedimiento ADMIN_COPY_SCHEMA - Copiarun esquema específico y sus objetos . . . . . 1055Procedimiento ADMIN_DROP_SCHEMA -Descartar un esquema específico y sus objetos . . 1059Procedimiento ADMIN_MOVE_TABLE - Trasladartablas en línea . . . . . . . . . . . . . 1062Procedimiento ADMIN_MOVE_TABLE_UTIL -Modificar el procedimiento de trasladar tablas enlínea . . . . . . . . . . . . . . . . 1082ALTOBJ . . . . . . . . . . . . . . . 1084APPLICATION_ID . . . . . . . . . . . 1087Función de tabla COMPILATION_ENV –Recuperar elementos del entorno de compilación . 1088Vista administrativa CONTACTGROUPS -Recuperar la lista de grupos de contacto . . . . 1091Vista administrativa CONTACTS - Recuperar listade contactos . . . . . . . . . . . . . 1092Vista administrativa DB_HISTORY - Recuperarinformación de archivo histórico . . . . . . 1093Vista administrativa DBPATHS – Recuperar víasde acceso de bases de datos . . . . . . . . 1098GET_DBSIZE_INFO . . . . . . . . . . . 1103Vista administrativa NOTIFICATIONLIST -Recuperar lista de contactos para notificación desalud . . . . . . . . . . . . . . . . 1105PD_GET_DIAG_HIST - Devolver registros de undeterminado recurso. . . . . . . . . . . 1106Vista administrativaPDLOGMSGS_LAST24HOURS y función de tablaPD_GET_LOG_MSGS – Recuperar mensajes dedeterminación de problemas . . . . . . . . 1113
Procedimiento REORGCHK_IX_STATS -Recuperar estadísticas de índice para evaluaciónde la reorganización . . . . . . . . . . . 1120Procedimiento REORGCHK_TB_STATS -Recuperar estadísticas de tabla para evaluación dela reorganización . . . . . . . . . . . . 1122Funciones escalares SQLERRM – Recuperarinformación de mensajes de error . . . . . . 1124SYSINSTALLOBJECTS . . . . . . . . . . 1127
Capítulo 22. Rutinas administrativasde SQL en desuso y sus vistas orutinas de sustitución . . . . . . . 1129Tabla de función ADMIN_GET_TAB_INFO -Recuperar información de tamaño y estado paralas tablas . . . . . . . . . . . . . . 1133Vista ADMINTABCOMPRESSINFO yADMIN_GET_TAB_COMPRESS_INFO . . . . 1140Vista administrativa ENV_SYS_RESOURCES -Devolver información de sistema . . . . . . 1146RGET_DB_CONFIG . . . . . . . . . . . 1149GET_DBM_CONFIG. . . . . . . . . . . 1151Rutinas de instantáneas de salud . . . . . . 1152
EALTH_CONT_HI . . . . . . . . . . 1152HEALTH_CONT_HI_HIS . . . . . . . . 1153HEALTH_CONT_INFO . . . . . . . . 1155HEALTH_DB_HI . . . . . . . . . . . 1157HEALTH_DB_HI_HIS . . . . . . . . . 1160HEALTH_DB_HIC . . . . . . . . . . 1164HEALTH_DB_HIC_HIS . . . . . . . . 1166HEALTH_DB_INFO . . . . . . . . . . 1169HEALTH_DBM_HI . . . . . . . . . . 1171HEALTH_DBM_HI_HIS . . . . . . . . 1172HEALTH_DBM_INFO . . . . . . . . . 1174HEALTH_GET_ALERT_ACTION_CFG . . . 1176HEALTH_GET_ALERT_CFG . . . . . . . 1179HEALTH_GET_IND_DEFINITION . . . . . 1182RHEALTH_HI_REC . . . . . . . . . . 1184HEALTH_TBS_HI . . . . . . . . . . 1186HEALTH_TBS_HI_HIS . . . . . . . . . 1189HEALTH_TBS_INFO . . . . . . . . . 1193
Vista administrativaSNAPAGENT_MEMORY_POOL y función detabla SNAP_GET_AGENT_MEMORY_POOL –Recuperar información de instantáneas del grupode datos lógicos memory_pool . . . . . . . 1195Función de tabla SNAP_GET_APPL – Recuperarinformación de instantáneas del grupo de datoslógico appl . . . . . . . . . . . . . . 1199Función de tabla SNAP_GET_APPL_INFO –Recuperación de información de instantáneas delgrupo de datos lógico appl_info . . . . . . . 1207Función de tabla SNAP_GET_BP – Recuperaciónde la información de instantáneas del grupo dedatos lógico bufferpool . . . . . . . . . . 1213SNAP_GET_CONTAINER. . . . . . . . . 1218SNAP_GET_DB . . . . . . . . . . . . 1219
Contenido ix
-
Vista administrativa SNAPDB_MEMORY_POOL yfunción de tablaSNAP_GET_DB_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . . 1228Función de tabla SNAP_GET_DBM –Recuperación de la información de instantáneasdel grupo de datos lógicos dbm . . . . . . . 1232Vista administrativa SNAPDBM_MEMORY_POOLy función de tablaSNAP_GET_DBM_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel del gestor de bases de datos . . . . . . 1236Función de tabla SNAP_GET_DB_V91 - Recuperarinformación de instantánea desde el grupo lógicodbase. . . . . . . . . . . . . . . . 1239Vista administrativa SNAPDB y función de tablaSNAP_GET_DB_V95 – Recuperar información deinstantánea desde el grupo lógico dbase . . . . 1252Función de tabla SNAP_GET_DYN_SQL_V91 -Recuperar información de la instantánea delgrupo de datos lógicos dynsql . . . . . . . 1266SNAP_GET_DYN_SQL . . . . . . . . . . 1270SNAP_GET_STO_PATHS . . . . . . . . . 1272SNAP_GET_TAB . . . . . . . . . . . . 1274SNAP_GET_TBSP . . . . . . . . . . . 1275SNAP_GET_TBSP_PART . . . . . . . . . 1279Vista administrativaSNAPAGENT_MEMORY_POOL y función detabla SNAP_GET_AGENT_MEMORY_POOL –Recuperar información de instantáneas del grupode datos lógicos memory_pool . . . . . . . 1281Vista administrativa SNAPDB_MEMORY_POOL yfunción de tablaSNAP_GET_DB_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . . 1286Vista administrativa SNAPDBM_MEMORY_POOLy función de tablaSNAP_GET_DBM_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel del gestor de bases de datos . . . . . . 1290Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK – Recuperar informaciónde instantáneas del grupo de datos lógicos lock . 1293Vista administrativa SNAPLOCKWAIT y funciónde tabla SNAP_GET_LOCKWAIT – Recuperarinformación de instantáneas del grupo de datoslógicos lockwait . . . . . . . . . . . . 1299SNAPSHOT_AGENT . . . . . . . . . . 1306SNAPSHOT_APPL . . . . . . . . . . . 1307SNAPSHOT_APPL_INFO . . . . . . . . . 1314SNAPSHOT_BP . . . . . . . . . . . . 1316SNAPSHOT_CONTAINER . . . . . . . . 1319SNAPSHOT_DATABASE . . . . . . . . . 1320SNAPSHOT_DBM . . . . . . . . . . . 1327SNAPSHOT_DYN_SQL . . . . . . . . . 1330
SNAPSHOT_FCM . . . . . . . . . . . 1332SNAPSHOT_FCMNODE . . . . . . . . . 1333SNAPSHOT_FILEW . . . . . . . . . . . 1334SNAPSHOT_LOCK . . . . . . . . . . . 1335SNAPSHOT_LOCKWAIT . . . . . . . . . 1337SNAPSHOT_QUIESCERS . . . . . . . . . 1339SNAPSHOT_RANGES . . . . . . . . . . 1340SNAPSHOT_STATEMENT . . . . . . . . 1341SNAPSHOT_SUBSECT . . . . . . . . . . 1344SNAPSHOT_SWITCHES . . . . . . . . . 1346SNAPSHOT_TABLE. . . . . . . . . . . 1348SNAPSHOT_TBREORG . . . . . . . . . 1349SNAPSHOT_TBS . . . . . . . . . . . . 1351SNAPSHOT_TBS_CFG . . . . . . . . . . 1354SQLCACHE_SNAPSHOT . . . . . . . . . 1356RSYSINSTALLROUTINES . . . . . . . . . 1358WLM_GET_ACTIVITY_DETAILS - Devolverinformación detallada sobre una actividadespecífica . . . . . . . . . . . . . . 1358WLM_GET_SERVICE_CLASS_AGENTS - Listaragentes en ejecución en una clase de servicio . . 1366WLM_GET_SERVICE_CLASS_WORKLOAD_OCURRENCES - Lista de las apariciones de cargade trabajo . . . . . . . . . . . . . . 1372WLM_GET_SERVICE_SUBCLASS_STATS -Devolver estadísticas de subclases de servicio . . 1376WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES - Devolver una lista de actividades . 1384WLM_GET_WORKLOAD_STATS - Devolverestadísticas de carga de trabajo . . . . . . . 1389
Apéndice A. Visión general de lainformación técnica de DB2 . . . . 1393Biblioteca técnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 1393Pedido de manuales de DB2 en copia impresa 1396Visualización de la ayuda para estados de SQLdesde el procesador de línea de mandatos . . . 1397Acceso a diferentes versiones del Centro deinformación de DB2 . . . . . . . . . . . 1398Visualización de temas en su idioma preferido enel Centro de información de DB2 . . . . . . 1398Actualización del Centro de información de DB2instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1399Actualización manual del Centro de informaciónde DB2 instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1400Guías de aprendizaje de DB2 . . . . . . . . 1402Información de resolución de problemas de DB2 1403Términos y condiciones . . . . . . . . . 1403
Apéndice B. Avisos . . . . . . . . 1405
Índice . . . . . . . . . . . . . . 1409
x Rutinas y vistas administrativas
-
Capítulo 1. Vistas y rutinas definidas por el sistema
Las vistas y rutinas definidas por el sistema proporcionan una interfazprogramática, fácil de utilizar y primaria, y usan DB2 mediante SQL. Incluyen unacolección de vistas incorporadas, funciones de tabla, procedimientos y funcionesescalares para realizar diversas tareas de DB2. Por ejemplo, las rutinas definidaspor el sistema están disponibles para reorganizar una tabla, capturar y recuperardatos del supervisor o recuperar el ID de aplicación de la conexión actual.
Estas rutinas y vistas se pueden invocar desde una aplicación basada en SQL, unalínea de mandatos de DB2 o un script de mandatos.
Recomendaciones para llamar a rutinas y vistas incorporadas enaplicaciones
Para garantizar un uso satisfactorio de las rutinas y vistas incorporadas, seaconseja aplicar determinadas recomendaciones de codificación. Talesrecomendaciones son especialmente importantes porque en ocasiones las rutinaspueden cambiar, como sucede de un release a otro cuando se efectúan mejoras.
Cuando emita una consulta para recuperar información mediante una rutina o unavista definida por el sistema, no utilice una sentencia del tipo SELECT * .... Porejemplo, no emita la consulta siguiente:SELECT * FROM TABLE(MON_GET_UNIT_OF_WORK(NULL,-1)) AS tORDER BY total_cpu_time DESC
En vez de ello, asigne un nombre a las columnas de resultado de la sentenciaSELECT. Esto proporcionará a la aplicación control sobre el número de columnasde resultado y la secuencia en la que se devuelven. Por ejemplo:SELECT application_handle,
uow_id,total_cpu_time,app_rqsts_completed_total,rqsts_completed_total
FROM TABLE(MON_GET_UNIT_OF_WORK(NULL,-1)) AS tORDER BY total_cpu_time DESC
Esto evita problemas cuando la secuencia y el número de columnas de las rutinascambian. Es posible que el número de las columnas de resultado que una rutinadevuelve pueda aumentar y, si, por ejemplo, proporciona sólo cinco variables dellenguaje principal cuando la rutina devuelva seis columnas de resultado, laaplicación dejará de funcionar.
Además, el tipo y el tamaño de los parámetros de salida o las columnas deresultado de las rutinas pueden cambiar; por ejemplo, una columna puede cambiarde VARCHAR(8) a VARCHAR(128) o una columna INTEGER puede convertirse enuna columna BIGINT. Si una variable de las que utiliza es demasiado pequeña, losdatos que reciba de la rutina podrían truncarse.
Para proteger a la aplicación de esos cambios, en el caso de aplicaciones C, puededescribir una sentencia preparada a fin de determinar las columnas de resultadoque se van a devolver y los tipos y tamaños que tienen. Por ejemplo, el siguiente
© Copyright IBM Corp. 2006, 2012 1
-
fragmento de código describe la consulta SELECT application_handle,uow_id,total_cpu_time FROM TABLE(MON_GET_UNIT_OF_WORK(NULL,-1)) AS t ORDERBY total_cpu_time DESC:strcpy(strStmt, "SELECT application_handle, uow_id,total_cpu_time
FROM TABLE(MON_GET_UNIT_OF_WORK(NULL,-1))AS t ORDER BY total_cpu_time DESC");
EXEC SQL PREPARE stmt FROM :strStmt;EXEC SQL DESCRIBE stmt into :*pSqlda;
Consulte la función RowDatamemoryAlloc en samples/c/tbread.sqc para obtenerinformación más detallada sobre cómo utilizar la información que se devuelve enSQLDA.
En el caso de las aplicaciones Java y .Net, si el tipo y el tamaño de los datosrepresenta un problema, puede utilizar metadatos para determinar las columnas deresultado que se van a devolver y sus tipos y tamaños. Por ejemplo:ResultSet rs = pstmt.executeQuery();ResultSetMetaData rsms = rs.getMetaData();
Consulte el método execPreparedQueryWithUnknownOutputColumn() ensamples/java/jdbc/TbRead.java para obtener información detallada sobre cómoutilizar los metadatos del conjunto de resultados.
Autorización para vistas administrativas
Para todas las vistas administrativas del esquema SYSIBMADM, necesita elprivilegio SELECT para la vista. Se puede validar con la consulta siguiente paracomprobar que su ID de autorización, o un grupo o un rol al que pertenezca,dispone del privilegio SELECT (es decir, cumple los criterios de búsqueda yaparece listado en la columna GRANTEE):SELECT GRANTEE, GRANTEETYPE
FROM SYSCAT.TABAUTHWHERE TABSCHEMA = ’SYSIBMADM’ AND TABNAME = ’’ ANDSELECTAUTH ’N’
donde es el nombre de la vista administrativa.
Con la excepción de SYSIBMADM.AUTHORIZATIONIDS,SYSIBMADM.OBJECTOWNERS y SYSIBMADM.PRIVILEGES, también necesita elprivilegio EXECUTE para la función de tabla administrativa. La función de tablaadministrativa subyacente aparece listada en la sección de autorización de la vistaadministrativa. Se puede validar con la consulta siguiente:SELECT GRANTEE, GRANTEETYPE
FROM SYSCAT.ROUTINEAUTHWHERE SCHEMA = ’SYSPROC’ AND SPECIFICNAME = ’’ ANDEXECUTEAUTH ’N’
donde es el nombre de la función de tabla administrativa talcomo aparece en la documentación.
Algunas vistas administrativas requieren autorizaciones adicionales además deSELECT para la vista y EXECUTE para la función de tabla administrativasubyacente. Las autorizaciones adicionales necesarias están documentadas en lainformación de consulta donde se describe la vista.
2 Rutinas y vistas administrativas
-
Vistas administrativas comparadas con funciones de tablas
DB2 Versión 9.5 introdujo vistas administrativas que proporcionan una interfaz deaplicación fácil de utilizar para las funciones administrativas de DB2 a través deSQL.
Las vistas administrativas se dividen en tres categorías:v Vistas basadas en vistas de catálogos.v Vistas basadas en funciones de tablas sin parámetros de entrada.v Vistas basadas en funciones de tablas con uno o más parámetros de entrada.
Las vistas administrativas son las únicas interfaces documentadas y las preferidaspara las vistas basadas en vistas de catálogos y las vistas basadas en funciones detablas sin parámetros de entrada porque las funciones de tablas no proporcionaninformación adicional ni ventajas en el rendimiento.
Para las vistas administrativas basadas en funciones de tablas con uno o másparámetros de entrada se pueden utilizar la vista administrativa y la función detabla, cada una de las cuales consigue un objetivo:v La vista administrativa ADMINTABINFO y la función de tabla
ADMIN_GET_TAB_INFO_V95: la vista administrativa recupera información paratodas las tablas de la base de datos. Esto puede tener ventajas significativas en elrendimiento de grandes bases de datos. El impacto en el rendimiento se puedereducir mediante el uso de la función de tabla y la especificación de unesquema, una tabla o ambos como entrada.
v La vista administrativa PDLOGMSGS_LAST24HOURS y la función de tablaPD_GET_LOG_MSGS: la vista administrativa, que recupera mensajes deanotaciones cronológicas de notificación, ofrece un acceso rápido a los datos delas últimas 24 horas, mientras que la función de tabla permite recuperar datosde un período concreto.
v Todas las vistas administrativas del supervisor de instantáneas y funciones detablas (vistas administrativas SNAP*, funciones de tablas SNAP_GET_*): lasvistas administrativas del supervisor de instantáneas ofrecen acceso a los datosdesde cada partición de base de datos. Las funciones de tablas ofrecen la opciónde elegir entre los datos de una única partición de base de datos o los datosagregados en todas las particiones de base de datos.
Es posible que se deban cambiar las aplicaciones que utilizan las funciones detablas en lugar de las vistas porque las funciones de tablas pueden cambiar encada versión, para habilitar que se devuelva la nueva información. La función detabla nueva tendrá el mismo nombre base que la función original y '_Vxx' seañadirá como sufijo, para indicar la versión del producto en que se añadió (porejemplo, _V97). Las vistas administrativas siempre se basarán en la versión másactual de las funciones de tablas, y por consiguiente permitirán una mayorportabilidad de aplicaciones. Puesto que las columnas pueden variar de unaversión a la siguiente, se recomienda la selección de columnas específicas desde lasvistas administrativas o que se describa el conjunto de resultados si una aplicaciónutiliza una sentencia SELECT *.
Capítulo 1. Vistas y rutinas definidas por el sistema 3
-
4 Rutinas y vistas administrativas
-
Capítulo 2. Rutinas y vistas de SQL definidas por el sistemasoportadas
Las tablas siguientes resumen información sobre las vistas y rutinasadministrativas SQL soportadas.v Rutinas administrativas SQL de supervisión de actividad: Tabla 1v Procedimiento ADMIN_CMD almacenado y rutinas administrativas SQL
asociadas: Tabla 2 en la página 6v Vistas y rutinas del planificador de tareas administrativas: Tabla 3 en la página 7v Comprobar rutinas y procedimientosTabla 4 en la página 7v Vistas y rutinas administrativas SQL del mantenimiento automático: Tabla 5 en
la página 7v Procedimientos almacenados de la API de SQL común: Tabla 6 en la página 8v Vistas y rutinas administrativas SQL de la configuración: Tabla 7 en la página 8v Entorno de vistas administrativas: Tabla 8 en la página 9v Rutinas administrativas SQL de instantáneas de salud: Tabla 9 en la página 9v Rutinas administrativas SQL de supervisión de actividad: Tabla 10 en la página
11v Rutinas administrativas SQL de MQSeries: Tabla 11 en la página 12v Vistas y rutinas administrativas SQL de la seguridad: Tabla 12 en la página 13v Vistas y rutinas administrativas SQL de instantáneas: Tabla 13 en la página 14v Rutinas administrativas SQL de procedimientos SQL: Tabla 14 en la página 18v Rutinas administrativas SQL de redistribución paso a paso: Tabla 15 en la página
18v Rutinas administrativas SQL de herramientas de almacenamiento: Tabla 16 en la
página 18v Rutinas administrativas SQL de búsqueda de texto: Tabla 17 en la página 19v Rutinas de gestión de carga de trabajo: Tabla 18 en la página 19v Vistas y rutinas administrativas SQL diversas: Tabla 19 en la página 20
Tabla 1. Rutinas administrativas SQL de supervisión de actividad
Nombre de la rutina Esquema Descripción
Función de tabla AM_BASE_RPT_RECOMS
SYSPROC Esta función de tabla devuelve lasrecomendaciones para los informes deactividad que utiliza el supervisor deactividad.
Función de tabla AM_BASE_RPTSSYSPROC Esta función de tabla devuelve los informes
de actividad que utiliza el supervisor deactividad.
Procedimiento AM_DROP_TASKSYSPROC Este procedimiento suprime una tarea de
supervisión.
Procedimiento AM_GET_LOCK_CHN_TBSYSPROC Este procedimiento devuelve datos de la
cadena de bloqueo de aplicación en formatotabular.
Procedimiento AM_GET_LOCK_CHNSSYSPROC Este procedimiento visualiza las series de
bloqueo de una aplicación especificadautilizando una serie con formato.
© Copyright IBM Corp. 2006, 2012 5
-
Tabla 1. Rutinas administrativas SQL de supervisión de actividad (continuación)
Nombre de la rutina Esquema Descripción
Procedimiento AM_GET_LOCK_RPTSYSPROC Este procedimiento visualiza los detalles del
bloque de una aplicación.
Procedimiento AM_GET_RPTSYSPROC Este procedimiento visualiza los datos sobre
el supervisor de actividad para un informe.
Procedimiento AM_SAVE_TASKSYSPROC Este procedimiento crea o modifica una tarea
de supervisión.
Tabla 2. Procedimiento ADMIN_CMD almacenado y rutinas administrativas SQL asociadas
Nombre de la rutina Esquema Descripción
Procedimiento ADMIN_CMD
SYSPROC Este procedimiento permite aladministrador ejecutar mandatosadministrativos (incluidos los mandatosCLP del procesador de línea de mandatosDB2 ejecutando ADMIN_CMD medianteuna sentencia CALL.
Función ADMIN_EST_INLINE_LENGTH
SYSIBM Esta función devuelve una estimación de lalongitud en línea necesaria para poner enlínea los datos almacenados en unacolumna XML, BLOB, CLOB o DBCLOB.
Función de tablaADMIN_GET_DBP_MEM_USAGE
SYSPROC Esta función de tabla obtiene el consumototal de memoria de una instanciadeterminada.
ADMIN_GET_INDEX_COMPRESS_INFO
SYSPROC Esta función de tabla devuelve los ahorrosde compresión de índice potenciales paraíndices no comprimidos o notifica lasestadísticas de compresión de índice desdelos catálogos.
Función de tabla ADMIN_GET_INDEX_INFOSYSPROC Esta función de tabla devuelve información
de índice que no está disponible en lasvistas de catálogo.
Función de tabla ADMIN_GET_MSGS
SYSPROC Esta función de tabla ADMIN_GET_MSGSse utiliza para recuperar los mensajesgenerados por un programa de utilidad demovimiento de datos que se ejecutamediante el procedimiento ADMIN_CMD.
Función ADMIN_IS_INLINED
SYSIBM Esta función recupera la información deestado de los datos en línea correspondientea una columna XML, BLOB, CLOB oDBCLOB.
Procedimiento ADMIN_REMOVE_MSGS
SYSPROC Este procedimiento se utiliza para borrar losmensajes generados por los programas deutilidad de movimiento de datos que seejecutan mediante el procedimientoADMIN_CMD.
ProcedimientoADMIN_REVALIDATE_DB_OBJECTS
SYSPROC Este procedimiento revalida objetos de basede datos no válidos.
Vista ADMINTABCOMPRESSINFO y funciónde tablaADMIN_GET_TAB_COMPRESS_INFO_V97
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista y esta función devuelveninformación de compresión para tablas,tablas de consulta materializada (MQT) ytablas de jerarquía.
6 Rutinas y vistas administrativas
-
Tabla 2. Procedimiento ADMIN_CMD almacenado y rutinas administrativas SQL asociadas (continuación)
Nombre de la rutina Esquema Descripción
ADMINTABINFO yADMIN_GET_TAB_INFO_V97
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista y esta función de tabla devuelveninformación de tamaño y estado para lastablas, las tablas de consulta materializada(MQT) y las tablas de jerarquía.
Vista ADMINTEMPCOLUMNS y función detabla ADMIN_GET_TEMP_COLUMNS
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista y esta función de tabla recuperaninformación de atributos de columna paralas tablas temporales creadas y las tablastemporales declaradas.
Vista ADMINTEMPTABLES y función de tablaADMIN_GET_TEMP_TABLES
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista y esta función de tabla recuperaninformación de atributos de tabla y detiempo de creación de instancias para lasinstancias de tablas temporales creadas ytablas temporales declaradas.
Tabla 3. Vistas y rutinas del planificador de tareas administrativas
Nombre de la vista o rutina Esquema Descripción
ADMIN_TASK_ADDSYSPROC Este procedimiento planifica una tarea
administrativa.
ADMIN_TASK_LISTSYSTOOLS Esta vista administrativa recupera
información sobre cada tarea definida en elplanificador.
ADMIN_TASK_REMOVESYSPROC Este procedimiento elimina registros de
estados de tareas o de tareas planificadas.
ADMIN_TASK_STATUSSYSTOOLS Esta vista administrativa recupera
información sobre el estado de cada tarea.
ADMIN_TASK_UPDATESYSPROC Este procedimiento actualiza una tarea
existente
Tabla 4. Comprobar rutinas y procedimientos
Nombre de la vista o rutina Esquema Descripción
Procedimiento y función de tablaAUDIT_ARCHIVE
SYSPROC Este procedimiento y la función de tablaarchivan el registro de comprobación actual.
Procedimiento AUDIT_DELIM_EXTRACT SYSPROC Este procedimiento extrae datos de losregistros archivados de forma binaria y loscarga en archivos delimitados.
Función de tabla AUDIT_LIST_LOGS SYSPROC Esta función de tabla devuelve una lista delos registros de comprobación archivadosen la vía de acceso especificada para la basede datos actual.
Tabla 5. Vistas y rutinas administrativas SQL del mantenimiento automático
Nombre de la vista o rutina Esquema Descripción
Procedimiento AUTOMAINT_GET_POLICY SYSPROC Este procedimiento obtiene los valoresactuales del mantenimiento automático parala base de datos.
ProcedimientoAUTOMAINT_GET_POLICYFILE
SYSPROC Este procedimiento obtiene los valoresactuales del mantenimiento automático parala base de datos.
Capítulo 2. Vistas y rutinas soportadas 7
-
Tabla 5. Vistas y rutinas administrativas SQL del mantenimiento automático (continuación)
Nombre de la vista o rutina Esquema Descripción
Procedimiento AUTOMAINT_SET_POLICY SYSPROC Este procedimiento establece los valores dela política de mantenimiento automáticopara la base de datos conectadaactualmente.
ProcedimientoAUTOMAINT_SET_POLICYFILE
SYSPROC Este procedimiento establece los valores delmantenimiento automático para la base dedatos conectada actualmente.
Tabla 6. Procedimientos almacenados de la API de SQL común
Nombre de la vista o rutina Esquema Descripción
Procedimiento CANCEL_WORK
SYSPROC Este procedimiento cancela una actividadespecificada. Si no se ha especificado un IDde actividad exclusivo, cancela todas lasactividades de una aplicación conectada yfuerza a la aplicación a salir del sistema.
Procedimiento DESIGN_ADVISORSYSPROC Este procedimiento recupera las
recomendaciones del asesor de diseñodesde un servidor de DB2.
Procedimiento GET_CONFIG
SYSPROC Este procedimiento recupera los datos deconfiguración del servidor de datos,incluidos los datos del archivo nodes.cfg,los datos de configuración del gestor debases de datos, los datos de configuraciónde la base de datos y los valores de registrode todas las particiones de base de datos.
Procedimiento GET_MESSAGESYSPROC Este procedimiento recupera el texto de
mensaje abreviado, el texto de mensajelargo y el SQLSTATE para un SQLCODE.
Procedimiento GET_SYSTEM_INFO
SYSPROC Este procedimiento recupera informaciónsobre el servidor de datos, incluidainformación sobre el sistema, la instanciaactual, los productos de base de datos DB2instalados, las variables de entorno, lasCPU disponibles y otra información desistema.
Procedimiento SET_CONFIGSYSPROC Este procedimiento actualiza los parámetros
de configuración recuperados con elprocedimiento GET_CONFIG.
Tabla 7. Vistas y rutinas administrativas SQL de la configuración
Nombre de la vista o rutina Esquema Descripción
Función de tabla DB_PARTITIONSSYSPROC Esta función de tabla devuelve el contenido
del archivo db2nodes.cfg en formato detabla.
Vista administrativa DBCFGSYSIBMADM Esta vista administrativa devuelve
información sobre la configuración de labase de datos.
Vista administrativa DBMCFGSYSIBMADM Esta vista administrativa devuelve
información sobre la configuración delgestor de bases de datos.
8 Rutinas y vistas administrativas
-
Tabla 7. Vistas y rutinas administrativas SQL de la configuración (continuación)
Nombre de la vista o rutina Esquema Descripción
Vista administrativa REG_VARIABLESSYSIBMADM Esta vista administrativa devuelve los
valores de registro de DB2 de todas lasparticiones de bases de datos.
Tabla 8. Vistas administrativas del entorno
Nombre de vista Esquema Descripción
Vista administrativa ENV_FEATURE_INFO
SYSPROC Esta vista administrativa devuelveinformación sobre todas las característicasdisponibles para las que se necesita unalicencia.
Vista administrativa ENV_INST_INFOSYSIBMADM Esta vista administrativa devuelve
información acerca de la instancia actual.
Vista administrativa ENV_PROD_INFOSYSIBMADM Esta vista administrativa devuelve
información acerca de los productos de basede datos DB2 instalados.
Vista administrativa ENV_SYS_INFOSYSIBMADM Esta vista administrativa devuelve
información acerca del sistema.
Vista administrativa ENV_SYS_RESOURCESSYSIBMADM Esta vista administrativa indica el sistema
operativo, la CPU, la memoria y demásinformación relacionada con el sistema
Tabla 9. Rutinas administrativas SQL de instantáneas de salud
Nombre de la rutina Esquema Descripción
Función de tabla HEALTH_CONT_HI
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el indicador desalud de los contenedores a partir de unainstantánea de salud de una base de datos.
Función de tabla HEALTH_CONT_HI_HIS
SYSPROC Esta función de tabla devuelve una tablacon la información histórica sobre elindicador de salud a partir de unainstantánea de salud de una base de datos.
Función de tabla HEALTH_CONT_INFO
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el estado de laalerta retrotraída para contenedores a partirde una instantánea de salud de una base dedatos.
Función de tabla HEALTH_DB_HI
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el indicador desalud a partir de una instantánea de saludde una base de datos.
Función de tabla HEALTH_DB_HI_HIS
SYSPROC Esta función de tabla devuelve una tablacon la información histórica sobre elindicador de salud a partir de unainstantánea de salud de una base de datos.
Función de tabla HEALTH_DB_HIC
SYSPROC Esta función de tabla devuelve informaciónsobre el indicador de salud de la coleccióna partir de una instantánea de salud de unabase de datos.
Capítulo 2. Vistas y rutinas soportadas 9
-
Tabla 9. Rutinas administrativas SQL de instantáneas de salud (continuación)
Nombre de la rutina Esquema Descripción
Función de tabla HEALTH_DB_HIC_HIS
SYSPROC Esta función de tabla devuelve informaciónhistórica sobre el indicador de salud de lacolección a partir de una instantánea desalud de una base de datos.
Función de tabla HEALTH_DB_INFO
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el estado de laalerta retrotraída a partir de unainstantánea de salud de una o de todas lasbases de datos.
Función de tabla HEALTH_DBM_HI
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el indicador desalud a partir de una instantánea de saluddel gestor de bases de datos DB2.
Función de tabla HEALTH_DBM_HI_HIS
SYSPROC Esta función de tabla devuelve una tablacon la información histórica sobre elindicador de salud a partir de unainstantánea de salud del gestor de bases dedatos DB2.
Función de tabla HEALTH_DBM_INFO
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el estado de laalerta retrotraída a partir de unainstantánea de salud del gestor de bases dedatos DB2.
Función de tablaHEALTH_GET_ALERT_ACTION_CFG
SYSPROC Esta función de tabla devuelve valores deconfiguración de acciones de alerta de saludcorrespondientes a diversos tipos de objetos(gestor de bases de datos, base de datos,espacio de tablas y contenedores deespacios de tablas) y a diversos niveles deconfiguración (valor por omisión deinstalación, instancia, global y objeto).
Función de tabla HEALTH_GET_ALERT_CFG
SYSPROC Esta función de tabla devuelve valores deconfiguración de alertas de saludcorrespondientes a diversos tipos de objetos(gestor de bases de datos, base de datos,espacio de tablas y contenedores deespacios de tablas) y a diversos niveles deconfiguración (valor por omisión deinstalación, global y objeto).
Función de tablaHEALTH_GET_IND_DEFINITION
SYSPROC Esta función de tabla devuelve lasdefiniciones del indicador de salud.
Procedimiento HEALTH_HI_REC
SYSPROC Este procedimiento recupera un conjunto derecomendaciones que direccionan unindicador de salud en estado de alerta enun objeto DB2 determinado.
Función de tabla HEALTH_TBS_HI
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el indicador desalud de los espacios de tablas a partir deuna instantánea de salud de una base dedatos.
10 Rutinas y vistas administrativas
-
Tabla 9. Rutinas administrativas SQL de instantáneas de salud (continuación)
Nombre de la rutina Esquema Descripción
Función de tabla HEALTH_TBS_HI_HIS
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el indicadorhistórico de salud de los espacios de tablasa partir de una instantánea de salud de unabase de datos.
Función de tabla HEALTH_TBS_INFO
SYSPROC Esta función de tabla devuelve una tablacon la información sobre el estado de laalerta retrotraída para espacios de tablas apartir de una instantánea de salud de unabase de datos.
Tabla 10. Rutinas de SQL del supervisor
Nombre de la rutina Esquema Descripción
Procedimiento EVMON_FORMAT_UE_TO_TABLES
SYSPROC Este procedimiento recupera los datosalmacenados en una tabla de sucesossin formato y mueve el documentoXML a un conjunto de tablasrelacionales.
Función de tabla EVMON_FORMAT_UE_TO_XML
SYSPROC Esta función de tabla extrae sucesosbinarios de una tabla de sucesos sinformato, les da formato y los incluyeen un documento XML.
MON_GET_ACTIVITY_DETAILS
SYSPROC Esta función de tabla devuelvedetalles sobre una actividad, incluidainformación de actividad general y unconjunto de métricas para laactividad.
Función de tabla MON_GET_BUFFERPOOL
SYSPROC Esta función de tabla devuelvemétricas del supervisor para una ovarias agrupaciones dealmacenamientos intermedios.
Función de tabla MON_GET_CONNECTIONSYSPROC Esta función de tabla devuelve
métricas para una o varias conexiones.
Función de tabla MON_GET_CONNECTION_DETAILSSYSPROC Esta función de tabla devuelve
métricas detalladas para una o variasconexiones.
Función de tabla MON_GET_CONTAINER
SYSPROC Esta función de tabla devuelvemétricas del supervisor para uno ovarios contenedores de espacios detablas.
Función de tablaMON_GET_EXTENT_MOVEMENT_STATUS
SYSPROC Esta función de tabla devuelve elestado de la operación de traslado deextensiones.
MON_GET_FCMSYSPROC Esta función de tabla devuelve
métricas para el gestor decomunicaciones rápidas (FCM).
MON_GET_FCM_CONNECTION_LIST
SYSPROC Esta función de tabla devuelvemétricas del supervisor para todas lasconexiones del gestor decomunicaciones rápidas (FCM) en losmiembros especificados.
Capítulo 2. Vistas y rutinas soportadas 11
-
Tabla 10. Rutinas de SQL del supervisor (continuación)
Nombre de la rutina Esquema Descripción
Función de tabla MON_GET_INDEXSYSPROC Esta función de tabla devuelve
métricas para uno o varios índices.
Función de tabla MON_GET_LOCKSSYSPROC Esta función de tabla devuelve una
lista de todos los bloqueos de la basede datos actualmente conectada.
Función de tabla MON_GET_MEMORY_POOL
SYSPROC Esta función de tabla recuperamétricas de las agrupaciones dememoria contenidas en un conjuntode memoria.
Función de tabla MON_GET_MEMORY_SET
SYSPROC Esta función de tabla recuperamétricas de los conjuntos de memoriaasignados, en el nivel de instancia ypara todas las bases de datos activasdentro de la instancia.
Función de tabla MON_GET_PKG_CACHE_STMT
SYSPROC Esta función de tabla devuelve unavista de punto en el tiempo de lassentencias de SQL tanto estático comodinámico en la antememoria delpaquete de bases de datos.
Función de tabla MON_GET_SERVICE_SUBCLASSSYSPROC Esta función de tabla devuelve
métricas para una o varias subclasesde servicio.
Función de tablaMON_GET_SERVICE_SUBCLASS_DETAILS
SYSPROC Esta función de tabla devuelvemétricas detalladas para una o variassubclases de servicio.
Función de tabla MON_GET_TABLESYSPROC Esta función de tabla devuelve
métricas del supervisor para una ovarias tablas.
Función de tabla MON_GET_TABLESPACESYSPROC Esta función de tabla devuelve
métricas del supervisor para uno ovarios espacios de tablas.
Función de tabla MON_GET_UNIT_OF_WORKSYSPROC Esta función de tabla devuelve
métricas para una o varias unidadesde trabajo.
Función de tablaMON_GET_UNIT_OF_WORK_DETAILS
SYSPROC Esta función de tabla devuelvemétricas detalladas para una o variasunidades de trabajo.
Función de tabla MON_GET_WORKLOADSYSPROC Esta función de tabla devuelve
métricas para una o varias cargas detrabajo.
Función de tabla MON_GET_WORKLOAD_DETAILSSYSPROC Esta función de tabla devuelve
métricas detalladas para una o variascargas de trabajo.
Tabla 11. Rutinas administrativas SQL de MQSeries
Nombre de la rutina Esquema Descripción
Función escalar MQPUBLISHDB2MQ, DB2MQ1C Esta función escalar publica datos en una
ubicación MQSeries.
Función escalar MQREADDB2MQ, DB2MQ1C Esta función escalar devuelve un mensaje
de una ubicación MQSeries.
12 Rutinas y vistas administrativas
-
Tabla 11. Rutinas administrativas SQL de MQSeries (continuación)
Nombre de la rutina Esquema Descripción
Función de tabla MQREADALLDB2MQ, DB2MQ1C Esta función de tabla devuelve una tabla
con mensajes y metadatos de mensajes deuna ubicación MQSeries.
Función de tabla MQREADALLCLOB
DB2MQ Esta función de tabla devuelve una tablaque contiene mensajes y metadatos demensajes desde una ubicación MQSeriesespecificada.
Función escalar MQREADCLOBDB2MQ Esta función escalar devuelve un mensaje
de una ubicación MQSeries especificada.
Función escalar MQRECEIVEDB2MQ, DB2MQ1C Esta función escalar devuelve un mensaje
de una ubicación MQSeries y suprime elmensaje de la cola asociada.
Función de tabla MQRECEIVEALL
DB2MQ, DB2MQ1C Esta función de tabla (una rutinaadministrativa de SQL) devuelve una tablaque contiene mensajes y metadatos de losmensajes desde una ubicación MQSeries ysuprime los mensajes de las colas asociadas.
Función de tabla MQRECEIVEALLCLOB
DB2MQ Esta función de tabla devuelve una tablaque contiene mensajes y metadatos demensajes desde una ubicación MQSeriesespecificada.
Función escalar MQRECEIVECLOBDB2MQ Esta función escalar devuelve un mensaje
de una ubicación MQSeries especificada.
Función escalar MQSENDDB2MQ, DB2MQ1C Esta función escalar envía datos a una
ubicación MQSeries.
Función escalar MQSUBSCRIBEDB2MQ, DB2MQ1C Esta función escalar suscribe a los mensajes
MQSeries publicados sobre un temaespecífico.
Función escalar MQUNSUBSCRIBEDB2MQ, DB2MQ1C Esta función escalar cancela la suscripción a
los mensajes MQSeries publicados sobre untema específico.
Tabla 12. Vistas y rutinas administrativas SQL de la seguridad:
Nombre de la vista o rutina Esquema Descripción
Función de tablaAUTH_LIST_AUTHORITIES_FOR_AUTHID
SYSPROC Esta función de tabla devuelve todas lasautorizaciones de este ID de autorizaciónencontradas en el archivo de configuraciónde la base de datos u otorgada a un ID deautorización directa o indirectamentemediante un grupo o un rol.
Función de tablaAUTH_LIST_GROUPS_FOR_AUTHID
SYSPROC Esta función de tabla devuelve la lista degrupos de los que es miembro el ID deautorización determinado.
Función AUTH_LIST_ROLES_FOR_AUTHIDSYSPROC Esta función devuelve la lista de roles de
los que es miembro el ID de autorizacióndeterminado.
Vista administrativa AUTHORIZATIONIDS
SYSIBMADM Esta vista administrativa contiene una listade los ID de autorización a los que se hanotorgado privilegios o autorizaciones, juntocon sus tipos, para la base de datosconectada actualmente.
Capítulo 2. Vistas y rutinas soportadas 13
-
Tabla 12. Vistas y rutinas administrativas SQL de la seguridad: (continuación)
Nombre de la vista o rutina Esquema Descripción
Vista administrativa OBJECTOWNERS
SYSIBMADM Esta vista administrativa contiene toda lainformación sobre la propiedad de objetoscorrespondiente a la base de datosconectada actualmente.
Vista administrativa PRIVILEGESSYSIBMADM Esta vista administrativa contiene todos los
privilegios explícitos correspondientes a labase de datos conectada actualmente.
Tabla 13. Vistas y rutinas administrativas SQL de instantáneas
Nombre de la vista o rutina Esquema Descripción
Vista administrativa APPL_PERFORMANCE
SYSIBMADM Esta vista administrativa muestrainformación acerca del índice filasseleccionado en comparación con las filasleídas por aplicación.
Vista administrativa APPLICATIONSSYSIBMADM Esta vista administrativa devuelve
información acerca de las aplicaciones debase de datos conectadas.
Vista administrativa BP_HITRATIO
SYSIBMADM Esta vista de administración devuelve latasa de aciertos de la agrupación deantememorias de la base de datos, incluidosel total, los datos y el índice.
Vista administrativa BP_READ_IO
SYSIBMADM Esta vista administrativa devuelveinformación sobre el rendimiento de lecturade la agrupación de almacenamientosintermedios.
Vista administrativa BP_WRITE_IO
SYSIBMADM Esta vista administrativa devuelveinformación sobre el rendimiento degrabación de cada agrupación dealmacenamientos intermedios.
Vista administrativaCONTAINER_UTILIZATION
SYSIBMADM Esta vista administrativa devuelveinformación acerca de los contenedores deespacios de tablas y los índices deutilización.
Vista administrativa LOCKS_HELDSYSIBMADM Esta vista administrativa devuelve
información acerca de los bloqueos actualesretenidos.
Vista administrativa LOCKWAITSSYSIBMADM Esta vista administrativa devuelve
información acerca de los bloqueos queestán a la espera de otorgarse.
Vista administrativa LOG_UTILIZATION
SYSIBMADM Esta vista administrativa devuelveinformación sobre la utilización de lasanotaciones cronológicas para la base dedatos conectada actualmente.
Vista administrativa LONG_RUNNING_SQLSYSIBMADM Esta vista administrativa devuelve las
sentencias SQL de ejecución más larga de labase de datos conectada actualmente.
Vista administrativa QUERY_PREP_COSTSYSIBMADM Esta vista administrativa devuelve una lista
de las sentencias con información acerca deltiempo necesario para preparar la sentencia.
14 Rutinas y vistas administrativas
-
Tabla 13. Vistas y rutinas administrativas SQL de instantáneas (continuación)
Nombre de la vista o rutina Esquema Descripción
Procedimiento SNAP_WRITE_FILE
SYSPROC Este procedimiento graba datos deinstantánea del sistema en un archivoubicado en el subdirectorio tmp deldirectorio de la instancia.
Vista administrativa SNAPAGENT y funciónde tabla SNAP_GET_AGENT
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de losagentes a partir de una instantánea de laaplicación, en concreto del grupo de datoslógico agent.
Vista administrativaSNAPAGENT_MEMORY_POOL y función detabla SNAP_GET_AGENT_MEMORY_POOL
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
La vista administrativa y la función detabla devuelven información acerca del usode la memoria a nivel de agente.
Vista administrativa SNAPAPPL y función detabla SNAP_GET_APPL_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de lasaplicaciones a partir de una instantánea dela aplicación, en concreto del grupo dedatos lógico appl.
Vista administrativa SNAPAPPL_INFO yfunción de tabla SNAP_GET_APPL_INFO_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de lasaplicaciones a partir de una instantánea dela aplicación, en concreto del grupo dedatos lógico appl_info.
Vista administrativa SNAPBP y función detabla SNAP_GET_BP_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de lasagrupaciones de almacenamientosintermedios a partir de una instantánea delas agrupaciones de almacenamientosintermedios, en concreto del grupo de datoslógico bufferpool.
Vista administrativa SNAPBP_PART y funciónde tabla SNAP_GET_BP_PART
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de lasagrupaciones de almacenamientosintermedios a partir de una instantánea delas agrupaciones de almacenamientosintermedios, en concreto del grupo de datoslógico bufferpool_nodeinfo.
Vista administrativa SNAPCONTAINER yfunción de tablaSNAP_GET_CONTAINER_V91
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de la instantáneadel espacio de tablas a partir del grupo dedatos lógicos tablespace_container.
Vista administrativa SNAPDB y función detabla SNAP_GET_DB_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de la instantánea apartir de los grupos lógicos de base dedatos (dbase) y de almacenamiento de basede datos (db_storage_group).
Vista administrativa SNAPDBM y función detabla SNAP_GET_DBM_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de los gruposlógicos del gestor de bases de datos DB2(dbm) y del supervisor de instantáneas.
Capítulo 2. Vistas y rutinas soportadas 15
-
Tabla 13. Vistas y rutinas administrativas SQL de instantáneas (continuación)
Nombre de la vista o rutina Esquema Descripción
Vista administrativa SNAPDETAILLOG yfunción de tabla SNAP_GET_DETAILLOG_V91
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos detail_log.
Vista administrativa SNAPDYN_SQL y funciónde tabla SNAP_GET_DYN_SQL_V95
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de las instantáneasa partir del grupo de datos lógicos dynsql.
Vista administrativa SNAPFCM y función detabla SNAP_GET_FCM
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información sobre FCM (FastCommunication Manager) a partir de unainstantánea del gestor de bases de datos, enconcreto, el grupo de datos lógicos fcm.
Vista administrativa SNAPFCM_PART yfunción de tabla SNAP_GET_FCM_PART
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información sobre FCM (FastCommunication Manager) a partir de unainstantánea del gestor de bases de datos, enconcreto, el grupo de datos lógicosfcm_node.
Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información sobre larecuperación de catástrofes de altadisponibilidad a partir de la instantánea deuna base de datos, en concreto el grupo dedatos lógicos hadr.
Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de instantáneasacerca de los bloqueos, en concreto el grupode datos lógicos lock.
Vista administrativa SNAPLOCKWAIT yfunción de tabla SNAP_GET_LOCKWAIT
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de instantáneasacerca de las esperas de bloqueo, enconcreto el grupo de datos lógicos lockwait.
Vista administrativa SNAPSTMT y función detabla SNAP_GET_STMT
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y funcióndevuelven información acerca de lassentencias de una instantánea de aplicación.
Vista administrativa SNAPSTORAGE_PATHS yfunción de tablaSNAP_GET_STORAGE_PATHS
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven una lista de vías de acceso delalmacenamiento automático para la base dedatos, incluida la información del sistemade archivos correspondiente a cada vía deacceso del almacenamiento, concretamentedel grupo de datos lógicosdb_storage_group.
Vista administrativa SNAPSUBSECTION yfunción de tabla SNAP_GET_SUBSECTION
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información sobre lassubsecciones de aplicaciones, concretamentela agrupación del supervisor lógicosubsection.
16 Rutinas y vistas administrativas
-
Tabla 13. Vistas y rutinas administrativas SQL de instantáneas (continuación)
Nombre de la vista o rutina Esquema Descripción
Vista administrativa SNAPSWITCHES yfunción de tabla SNAP_GET_SWITCHES
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca del estadodel conmutador de instantánea de base dedatos.
Vista administrativa SNAPTAB y función detabla SNAP_GET_TAB_V91
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos table.
Vista administrativa SNAPTAB_REORG yfunción de tabla SNAP_GET_TAB_REORG
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de lareorganización de tabla.
Vista administrativa SNAPTBSP y función detabla SNAP_GET_TBSP_V91
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos table space.
Vista administrativa SNAPTBSP_PART yfunción de tabla SNAP_GET_TBSP_PART_V91
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicostablespace_nodeinfo.
Vista administrativa SNAPTBSP_QUIESCER yfunción de tabla SNAP_GET_TBSP_QUIESCER
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca de losinmovilizadores desde una instantánea delespacio de tablas.
Vista administrativa SNAPTBSP_RANGE yfunción de tabla SNAP_GET_TBSP_RANGE
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de una instantáneade rango.
Vista administrativa SNAPUTIL y función detabla SNAP_GET_UTIL
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información de instantáneasacerca de los programas de utilidad delgrupo de datos lógicos utility_info.
Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_GET_UTIL_PROGRESS
SYSIBMADM (vistaadministrativa),SYSPROC (función detabla)
Esta vista administrativa y función de tabladevuelven información acerca del progresode los programas de utilidad, en particular,el grupo de datos lógicos progress.
Vista administrativa TBSP_UTILIZATIONSYSIBMADM Esta vista administrativa devuelve
información de utilización y configuraciónde espacio de tablas.
Vista administrativa TOP_DYNAMIC_SQL
SYSIBMADM Esta vista administrativa devuelve lassentencias de SQL dinámico más frecuentesque pueden clasificarse por número deejecuciones, tiempo de ejecución medio,número de clasificaciones o clasificacionespor sentencia.
Capítulo 2. Vistas y rutinas soportadas 17
-
Tabla 14. Rutinas administrativas SQL de procedimientos SQL
Nombre de la rutina Esquema Descripción
Procedimiento ALTER_ROUTINE_PACKAGE
SYSPROC Este procedimiento modifica los valores delpaquete asociado con una rutina de SQLcompilado o un activador compilado, sinnecesidad de realizar revinculaciones.
Función escalar GET_ROUTINE_OPTS
SYSPROC Esta función escalar devuelve un valor deserie de caracteres de las opciones quedeben utilizarse para la creación deprocedimientos SQL en la sesión actual.
Procedimiento GET_ROUTINE_SAR
SYSFUN Este procedimiento devuelve la informaciónnecesaria para instalar una rutina idénticaen otro servidor de bases de datos quefuncione por lo menos al mismo nivel y conel mismo sistema operativo.
Procedimiento PUT_ROUTINE_SARSYSFUN Este procedimiento pasa la información
necesaria para crear y definir una rutinaSQL en el servidor de bases de datos.
Procedimiento REBIND_ROUTINE_PACKAGESYSPROC Este procedimiento vuelve a vincular el
paquete asociado con un procedimiento deSQL.
Procedimiento SET_ROUTINE_OPTSSYSPROC Este procedimiento establece las opciones
que deben utilizarse para la creación deprocedimientos SQL en la sesión actual.
Tabla 15. Rutinas administrativas SQL de redistribución paso a paso
Nombre de la rutina Esquema Descripción
Procedimiento ANALYZE_LOG_SPACESYSPROC Este procedimiento devuelve información
de análisis del espacio de anotacionescronológicas.
Procedimiento GENERATE_DISTFILESYSPROC Este procedimiento genera un archivo de
distribución de datos.
Procedimiento GET_SWRD_SETTINGSSYSPROC Este procedimiento devuelve información
de redistribución.
Procedimiento SET_SWRD_SETTINGSSYSPROC Este procedimiento crea o modifica el
registro de redistribución.
ProcedimientoSTEPWISE_REDISTRIBUTE_DBPG
SYSPROC Este procedimiento redistribuye parte deun grupo de particiones de base de datos.
Tabla 16. Rutinas administrativas SQL de la herramienta de administración del almacenamiento
Nombre de la rutina Esquema Descripción
ProcedimientoCAPTURE_STORAGEMGMT_INFO
SYSPROC Este procedimiento devuelve informaciónrelacionada con el almacenamiento de unobjeto raíz concreto.
ProcedimientoCREATE_STORAGEMGMT_TABLES
SYSPROC Este procedimiento crea tablas de gestiónde almacenamiento.
ProcedimientoDROP_STORAGEMGMT_TABLES
SYSPROC Este procedimiento inactiva las tablas degestión de almacenamiento.
18 Rutinas y vistas administrativas
-
Tabla 17. Rutinas administrativas SQL de búsqueda de texto
Nombre de la rutina Esquema Descripción
Procedimiento almacenadoSYSTS_ADMIN_CMD
SYSPROC Este procedimiento ejecuta mandatosadministrativos de búsqueda de textoutilizando la sentencia SQL CALL.
Procedimiento SYSTS_ALTERSYSPROC Este procedimiento cambia las
características de actualización de uníndice.
ProcedimientoSYSTS_CLEAR_COMMANDLOCKS
SYSPROC Este procedimiento elimina todos losbloqueos d