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

1435
DB2 para Linux, UNIX y Windows Rutinas y vistas administrativas Actualizado en julio de 2012 Versión 9 Release 7 SC11-3909-03

Upload: others

Post on 23-Jul-2020

44 views

Category:

Documents


0 download

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