public.dhe.ibm.compublic.dhe.ibm.com/ps/products/db2/info/vr95/pdf/es_ES/DB2Admin... · EALTH_CONT_HI ..........272 HEALTH_CONT_HI_HIS ........274 HEALTH_CONT_INFO .........276 HEALTH_DB_HI

DB2 Versión 9.5para Linux, UNIX y Windows

Rutinas y vistas administrativasActualizado en diciembre de 2010

Versión 9 Release 5

SC11-3507-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 931.

Nota de edición

Este manual es la traducción del original en inglés DB2 Version 9.5 for Linux, UNIX, and Windows Version 9 Release 5Administrative Routines and Views Updated December, 2010 (SC23-5843-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, 2010.

Contenido

Parte 1. Vistas y rutinasadministrativas SQL . . . . . . . . 1

Capítulo 1. Autorización para vistasadministrativas. . . . . . . . . . . . 3

Capítulo 2. Vistas administrativascomparadas con funciones de tablas . . 5

Capítulo 3. Vistas y rutinasadministrativas de SQL soportadas . . . 7Rutinas del supervisor de actividades . . . . . 21

AM_BASE_RPT_RECOMS – Recomendacionespara informes de actividad . . . . . . . . 21AM_BASE_RPTS – Informes del supervisor deactividad . . . . . . . . . . . . . . 22RAM_DROP_TASK – Supresión de una tarea desupervisión . . . . . . . . . . . . . 24RAM_GET_LOCK_CHN_TB – Recuperación delos datos de la cadena de bloqueo de laaplicación en formato tabular . . . . . . . 24RAM_GET_LOCK_CHNS – Recuperación deinformación de bloqueo de cadenas para unaaplicación específica . . . . . . . . . . 25RAM_GET_LOCK_RPT – Recuperación de losdetalles del bloqueo de la aplicación . . . . . 26RAM_GET_RPT – Recuperación de datos delsupervisor de actividad . . . . . . . . . 33RAM_SAVE_TASK – Creación o modificación deuna tarea de supervisión . . . . . . . . . 34

Procedimiento ADMIN_CMD y rutinas asociadas . 36ADMIN_CMD – Ejecutar mandatosadministrativos . . . . . . . . . . . . 36Función de tablaADMIN_GET_DBP_MEM_USAGE - Obtener elconsumo de memoria total por instancia . . . 218Función de tabla ADMIN_GET_MSGS -Recuperar mensajes generados por un programade utilidad de movimiento de datos que utilizael procedimiento ADMIN_CMD . . . . . . 220Vista ADMINTABCOMPRESSINFO yADMIN_GET_TAB_COMPRESS_INFO . . . . 221Procedimiento ADMIN_REMOVE_MSGS -Limpiar los mensaje que genera un programade utilidad de movimiento de datos que utilizael procedimiento ADMIN_CMD . . . . . . 226Vista administrativa ADMINTABINFO yfunción de tabla ADMIN_GET_TAB_INFO_V95– Recuperar información de tamaño y estadopara las tablas . . . . . . . . . . . . 227

Vistas y rutinas del planificador de tareasadministrativas . . . . . . . . . . . . . 234

Procedimiento ADMIN_TASK_ADD - Planificaruna nueva tarea . . . . . . . . . . . 234

Vista administrativa ADMIN_TASK_LIST -Recuperar información sobre las tareas en elplanificador . . . . . . . . . . . . . 240Procedimiento ADMIN_TASK_REMOVE -Eliminar registros de tareas planificadas o deestados de tareas . . . . . . . . . . . 242Vista administrativa ADMIN_TASK_STATUS -Recuperar información de estado de tarea . . . 243Procedimiento ADMIN_TASK_UPDATE -Actualizar una tarea existente . . . . . . . 246

Rutinas y procedimientos de auditoría . . . . . 248Procedimiento y función de tablaAUDIT_ARCHIVE - Archivar archivo deanotaciones cronológicas de auditoría . . . . 248AUDIT_DELIM_EXTRACT - realiza unaextracción al archivo delimitado . . . . . . 249Función de tabla AUDIT_LIST_LOGS - Enumeralos archivos de anotaciones cronológicas deauditoría archivados . . . . . . . . . . 250

Rutinas de mantenimiento automático . . . . . 251Procedimiento AUTOMAINT_GET_POLICY -recuperar la política de mantenimientoautomático . . . . . . . . . . . . . 251ProcedimientoAUTOMAINT_GET_POLICYFILE - recuperar lapolítica de mantenimiento automático . . . . 252Procedimiento AUTOMAINT_SET_POLICY -Configuración de una política de mantenimientoautomático . . . . . . . . . . . . . 254Procedimiento AUTOMAINT_SET_POLICYFILE- configurar la política de mantenimientoautomático . . . . . . . . . . . . . 255

Rutinas y vistas de configuración. . . . . . . 256DB_PARTITIONS . . . . . . . . . . . 256Vista administrativa DBCFG - Recuperarinformación sobre los parámetros deconfiguración de la base de datos . . . . . 257Vista administrativa DBMCFG - Recuperarinformación sobre los parámetros deconfiguración del gestor de bases de datos . . 259Vista administrativa REG_VARIABLES -Recuperar valores de registro de DB2 en uso . . 262

Vistas del entorno . . . . . . . . . . . . 264Vista administrativa ENV_INST_INFO –Recuperar información sobre la instancia actual . 264Vista administrativa ENV_PROD_INFO -Recuperar información sobre productos DB2instalados . . . . . . . . . . . . . 265Vista administrativa ENV_FEATURE_INFO -Devolver información de licencia para lascaracterísticas de DB2 . . . . . . . . . 266Vista administrativa ENV_SYS_INFO –Recuperar información sobre el sistema . . . 268Vista administrativa ENV_SYS_RESOURCES -Devolver información de sistema . . . . . . 268

Rutinas de instantáneas de salud . . . . . . . 272

© Copyright IBM Corp. 2006, 2010 iii

EALTH_CONT_HI . . . . . . . . . . 272HEALTH_CONT_HI_HIS . . . . . . . . 274HEALTH_CONT_INFO . . . . . . . . . 276HEALTH_DB_HI . . . . . . . . . . . 277HEALTH_DB_HI_HIS . . . . . . . . . 281HEALTH_DB_HIC . . . . . . . . . . 284HEALTH_DB_HIC_HIS . . . . . . . . . 286HEALTH_DB_INFO . . . . . . . . . . 289HEALTH_DBM_HI . . . . . . . . . . 291HEALTH_DBM_HI_HIS . . . . . . . . . 292HEALTH_DBM_INFO . . . . . . . . . 294Función de tablaHEALTH_GET_ALERT_ACTION_CFG -Recuperar valores de configuración de accionesde alerta de salud . . . . . . . . . . . 296Función de tabla HEALTH_GET_ALERT_CFG –Recuperar valores de configuración de alerta desalud . . . . . . . . . . . . . . . 299Función de tablaHEALTH_GET_IND_DEFINITION – Recuperardefiniciones de indicador de salud . . . . . 302RHEALTH_HI_REC . . . . . . . . . . 304HEALTH_TBS_HI . . . . . . . . . . . 306HEALTH_TBS_HI_HIS . . . . . . . . . 308HEALTH_TBS_INFO . . . . . . . . . . 312

Rutinas de MQSeries . . . . . . . . . . . 313MQPUBLISH . . . . . . . . . . . . 313MQREAD . . . . . . . . . . . . . 315MQREADALL . . . . . . . . . . . . 316MQREADALLCLOB . . . . . . . . . . 318MQREADCLOB . . . . . . . . . . . 320MQRECEIVE . . . . . . . . . . . . 321MQRECEIVEALL . . . . . . . . . . . 322MQRECEIVEALLCLOB . . . . . . . . . 325MQRECEIVECLOB . . . . . . . . . . 327MQSEND . . . . . . . . . . . . . 328MQSUBSCRIBE . . . . . . . . . . . 330MQUNSUBSCRIBE . . . . . . . . . . 331

Rutinas y vistas de seguridad . . . . . . . . 332AUTH_LIST_AUTHORITIES_FOR_AUTHID 332Función de tablaAUTH_LIST_GROUPS_FOR_AUTHID –Recuperar lista de pertenencia al grupo para unID de autorización determinado . . . . . . 336Función AUTH_LIST_ROLES_FOR_AUTHID -Devuelve la lista de funciones . . . . . . . 337Vista administrativa AUTHORIZATIONIDS –Recuperar ID y tipos de autorización . . . . 339Vista administrativa OBJECTOWNERS –Recuperar información sobre propiedad deobjetos . . . . . . . . . . . . . . 340Vista administrativa PRIVILEGES – Recuperarinformación sobre privilegios . . . . . . . 341

Rutinas y vistas de instantáneas . . . . . . . 342Vista administrativa APPL_PERFORMANCE –Recuperar porcentaje de filas seleccionadas parauna aplicación . . . . . . . . . . . . 342Vista administrativa APPLICATIONS –Recuperar información de aplicación de base dedatos conectada . . . . . . . . . . . 343

Vista administrativa BP_HITRATIO – Recuperarinformación sobre la tasa de aciertos deagrupación de almacenamientos intermedios . . 347Vista administrativa BP_READ_IO – Recuperarinformación de rendimiento de lectura de lasagrupaciones de almacenamientos intermedios . 349Vista administrativa BP_WRITE_IO – Recuperarinformación de rendimiento de grabación de lasagrupaciones de almacenamientos intermedios . 351Vista administrativaCONTAINER_UTILIZATION – Recuperarinformación de utilización y contenedores deespacio de tablas . . . . . . . . . . . 353Vista administrativa LOCKS_HELD – Recuperarinformación acerca de los bloqueos retenidos . . 355Vista administrativa LOCKWAITS – Recuperarinformación de bloqueos actuales en espera deser activados . . . . . . . . . . . . 357Vista administrativa LOG_UTILIZATION –Recuperar información de utilización de lasanotaciones cronológicas . . . . . . . . 361Vista administrativa LONG_RUNNING_SQL 362Vista administrativa QUERY_PREP_COST –Recuperar información de tiempo depreparación de sentencias . . . . . . . . 365Vista administrativa SNAPAGENT y función detabla SNAP_GET_AGENT – Recuperarinformación de instantáneas de la aplicación delgrupo de datos lógicos agent . . . . . . . 366Vista administrativaSNAPAGENT_MEMORY_POOL y función detabla SNAP_GET_AGENT_MEMORY_POOL –Recuperar información de instantáneas delgrupo de datos lógicos memory_pool . . . . 369Vista administrativa SNAPAPPL_INFO yfunción de tabla SNAP_GET_APPL_INFO_V95– Recuperar información de instantáneas delgrupo de datos lógicos appl_info . . . . . . 373Vista administrativa SNAPAPPL y función detabla SNAP_GET_APPL_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos appl . . . . . . . . . . . . . 380Vista administrativa SNAPBP y función de tablaSNAP_GET_BP_V95 – Recuperar informaciónde instantáneas del grupo lógico bufferpool . . 389Vista administrativa SNAPBP_PART y funciónde tabla SNAP_GET_BP_PART – Recuperarinformación de instantáneas del grupo de datoslógicos bufferpool_nodeinfo . . . . . . . 395Vista administrativa SNAPCONTAINER yfunción de tabla SNAP_GET_CONTAINER_V91– Recuperar información acerca de lainstantánea de grupo de datos lógicostablespace_container . . . . . . . . . . 398Vista administrativa SNAPDB y función detabla SNAP_GET_DB_V95 – Recuperarinformación de instantánea desde el grupológico dbase . . . . . . . . . . . . . 402

iv Rutinas y vistas administrativas

Vista administrativa SNAPDB_MEMORY_POOLy función de tablaSNAP_GET_DB_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . 415Vista administrativa SNAPDBM y función detabla SNAP_GET_DBM_V95 – Recuperar lainformación de instantáneas del grupo de datoslógicos dbm . . . . . . . . . . . . . 419Vista administrativaSNAPDBM_MEMORY_POOL y función de tablaSNAP_GET_DBM_MEMORY_POOL –Recuperar información sobre el uso de lamemoria en el nivel del gestor de bases dedatos . . . . . . . . . . . . . . . 424Vista administrativa SNAPDETAILLOG yfunción de tabla SNAP_GET_DETAILLOG_V91– Recuperar información de instantánea desdeel grupo de datos lógicos detail_log . . . . . 427Vista administrativa SNAPDYN_SQL y funciónde tabla SNAP_GET_DYN_SQL_V95 –Recuperar información de instantáneas delgrupo de datos lógicos dynsql . . . . . . . 430Vista administrativa SNAPFCM y función detabla SNAP_GET_FCM – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm . . . . . . . . . . . . . 435Vista administrativa SNAPFCM_PART y funciónde tabla SNAP_GET_FCM_PART – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm_node . . . . . . . . . . . 437Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR – Recuperarinformación de instantáneas del grupo de datoslógicos hadr . . . . . . . . . . . . . 440Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK – Recuperarinformación de instantáneas del grupo de datoslógicos lock . . . . . . . . . . . . . 444Vista administrativa SNAPLOCKWAIT yfunción de tabla SNAP_GET_LOCKWAIT –Recuperar información de instantáneas delgrupo de datos lógicos lockwait . . . . . . 449Vista administrativa SNAPSTMT y función detabla SNAP_GET_STMT – Recuperarinformación de instantáneas de sentencias . . . 455Vista administrativa SNAPSTORAGE_PATHS yfunción de tabla SNAP_GET_STORAGE_PATHS– Recuperar información de vía de acceso delalmacenamiento automático . . . . . . . 462Vista administrativa SNAPSUBSECTION yfunción de tabla SNAP_GET_SUBSECTION –Recuperar información de instantáneas delgrupo de supervisor lógico de la subsección . . 465Vista administrativa SNAPSWITCHES y funciónde tabla SNAP_GET_SWITCHES – Recuperarinformación acerca del estado del conmutadorde instantánea de base de datos . . . . . . 468

Vista administrativa SNAPTAB y función detabla SNAP_GET_TAB_V91 – Recuperarinformación de instantáneas del grupo de datoslógicos table . . . . . . . . . . . . . 472Vista administrativa SNAPTAB_REORG yfunción de tabla SNAP_GET_TAB_REORG -Recuperar información sobre instantáneas dereorganización de tabla . . . . . . . . . 475Vista administrativa SNAPTBSP y función detabla SNAP_GET_TBSP_V91 – Recuperarinformación de instantáneas del grupo de datoslógicos de espacio de tablas . . . . . . . 479Vista administrativa SNAPTBSP_PART yfunción de tabla SNAP_GET_TBSP_PART_V91 –Recuperar información de instantáneas delgrupo de datos lógicos tablespace_nodeinfo . . 485Vista administrativa SNAPTBSP_QUIESCER yfunción de tabla SNAP_GET_TBSP_QUIESCER– Recuperar información acerca de lainstantánea de espacio de tablas deinmovilizador . . . . . . . . . . . . 490Vista administrativa SNAPTBSP_RANGE yfunción de tabla SNAP_GET_TBSP_RANGE –Recuperar información acerca de la instantáneade rango . . . . . . . . . . . . . . 494Vista administrativa SNAPUTIL y función detabla SNAP_GET_UTIL – Recuperar informaciónacerca de la instantánea de grupo de datoslógicos utility_info. . . . . . . . . . . 498Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_GET_UTIL_PROGRESS– Recuperar información acerca de lainstantánea de grupo de datos lógicos deprogreso . . . . . . . . . . . . . . 501Procedimiento SNAP_WRITE_FILE . . . . . 504Vista administrativa SNAPAGENT y función detabla SNAP_GET_AGENT – Recuperarinformación de instantáneas de la aplicación delgrupo de datos lógicos agent . . . . . . . 506Vista administrativaSNAPAGENT_MEMORY_POOL y función detabla SNAP_GET_AGENT_MEMORY_POOL –Recuperar información de instantáneas delgrupo de datos lógicos memory_pool . . . . 509Vista administrativa SNAPAPPL_INFO yfunción de tabla SNAP_GET_APPL_INFO_V95– Recuperar información de instantáneas delgrupo de datos lógicos appl_info . . . . . . 512Vista administrativa SNAPAPPL y función detabla SNAP_GET_APPL_V95 – Recuperarinformación de instantáneas del grupo de datoslógicos appl . . . . . . . . . . . . . 520Vista administrativa SNAPBP y función de tablaSNAP_GET_BP_V95 – Recuperar informaciónde instantáneas del grupo lógico bufferpool . . 529Vista administrativa SNAPBP_PART y funciónde tabla SNAP_GET_BP_PART – Recuperarinformación de instantáneas del grupo de datoslógicos bufferpool_nodeinfo . . . . . . . 535

Contenido v

Vista administrativa SNAPCONTAINER yfunción de tabla SNAP_GET_CONTAINER_V91– Recuperar información acerca de lainstantánea de grupo de datos lógicostablespace_container . . . . . . . . . . 538Vista administrativa SNAPDB y función detabla SNAP_GET_DB_V95 – Recuperarinformación de instantánea desde el grupológico dbase . . . . . . . . . . . . . 542Vista administrativa SNAPDB_MEMORY_POOLy función de tablaSNAP_GET_DB_MEMORY_POOL – Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . 555Vista administrativa SNAPDBM y función detabla SNAP_GET_DBM_V95 – Recuperar lainformación de instantáneas del grupo de datoslógicos dbm . . . . . . . . . . . . . 559Vista administrativaSNAPDBM_MEMORY_POOL y función de tablaSNAP_GET_DBM_MEMORY_POOL –Recuperar información sobre el uso de lamemoria en el nivel del gestor de bases dedatos . . . . . . . . . . . . . . . 564Vista administrativa SNAPDETAILLOG yfunción de tabla SNAP_GET_DETAILLOG_V91– Recuperar información de instantánea desdeel grupo de datos lógicos detail_log . . . . . 567Vista administrativa SNAPDYN_SQL y funciónde tabla SNAP_GET_DYN_SQL_V95 –Recuperar información de instantáneas delgrupo de datos lógicos dynsql . . . . . . . 570Vista administrativa SNAPFCM y función detabla SNAP_GET_FCM – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm . . . . . . . . . . . . . 575Vista administrativa SNAPFCM_PART y funciónde tabla SNAP_GET_FCM_PART – Recuperar lainformación de instantáneas del grupo de datoslógicos fcm_node . . . . . . . . . . . 577Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR – Recuperarinformación de instantáneas del grupo de datoslógicos hadr . . . . . . . . . . . . . 580Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK – Recuperarinformación de instantáneas del grupo de datoslógicos lock . . . . . . . . . . . . . 584Vista administrativa SNAPLOCKWAIT yfunción de tabla SNAP_GET_LOCKWAIT –Recuperar información de instantáneas delgrupo de datos lógicos lockwait . . . . . . 589Vista administrativa SNAPSTMT y función detabla SNAP_GET_STMT – Recuperarinformación de instantáneas de sentencias . . . 595Vista administrativa SNAPSTORAGE_PATHS yfunción de tabla SNAP_GET_STORAGE_PATHS– Recuperar información de vía de acceso delalmacenamiento automático . . . . . . . 602

Vista administrativa SNAPSUBSECTION yfunción de tabla SNAP_GET_SUBSECTION –Recuperar información de instantáneas delgrupo de supervisor lógico de la subsección . . 605Vista administrativa SNAPSWITCHES y funciónde tabla SNAP_GET_SWITCHES – Recuperarinformación acerca del estado del conmutadorde instantánea de base de datos . . . . . . 608Vista administrativa SNAPTAB y función detabla SNAP_GET_TAB_V91 – Recuperarinformación de instantáneas del grupo de datoslógicos table . . . . . . . . . . . . . 612Vista administrativa SNAPTAB_REORG yfunción de tabla SNAP_GET_TAB_REORG -Recuperar información sobre instantáneas dereorganización de tabla . . . . . . . . . 615Vista administrativa SNAPTBSP y función detabla SNAP_GET_TBSP_V91 – Recuperarinformación de instantáneas del grupo de datoslógicos de espacio de tablas . . . . . . . 619Vista administrativa SNAPTBSP_PART yfunción de tabla SNAP_GET_TBSP_PART_V91 –Recuperar información de instantáneas delgrupo de datos lógicos tablespace_nodeinfo . . 625Vista administrativa SNAPTBSP_QUIESCER yfunción de tabla SNAP_GET_TBSP_QUIESCER– Recuperar información acerca de lainstantánea de espacio de tablas deinmovilizador . . . . . . . . . . . . 630Vista administrativa SNAPTBSP_RANGE yfunción de tabla SNAP_GET_TBSP_RANGE –Recuperar información acerca de la instantáneade rango . . . . . . . . . . . . . . 634Vista administrativa SNAPUTIL y función detabla SNAP_GET_UTIL – Recuperar informaciónacerca de la instantánea de grupo de datoslógicos utility_info. . . . . . . . . . . 638Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_GET_UTIL_PROGRESS– Recuperar información acerca de lainstantánea de grupo de datos lógicos deprogreso . . . . . . . . . . . . . . 641Procedimiento SNAP_WRITE_FILE . . . . . 644Vista administrativa TBSP_UTILIZATION –Recuperar información de utilización yconfiguración de espacio de tablas . . . . . 646Vista administrativa TOP_DYNAMIC_SQL –Recuperar información acerca de las sentenciasde SQL dinámico más frecuentes . . . . . . 648

Rutinas de procedimientos de SQL . . . . . . 650RGET_ROUTINE_OPTS . . . . . . . . . 650GET_ROUTINE_SAR . . . . . . . . . . 650PUT_ROUTINE_SAR . . . . . . . . . . 651REBIND_ROUTINE_PACKAGE . . . . . . 653RSET_ROUTINE_OPTS . . . . . . . . . 653

Rutinas de redistribución paso a paso . . . . . 654Procedimiento ANALYZE_LOG_SPACE -Recuperar información de análisis de espacio deanotaciones . . . . . . . . . . . . . 654Procedimiento GENERATE_DISTFILE - Generararchivo de distribución de datos . . . . . . 657

vi Rutinas y vistas administrativas

Procedimiento GET_SWRD_SETTINGS -Recuperar información de redistribución . . . 658Procedimiento SET_SWRD_SETTINGS - Crear ocambiar registro de redistribución . . . . . 660ProcedimientoSTEPWISE_REDISTRIBUTE_DBPG -Redistribuir parte del grupo de particiones debase de datos . . . . . . . . . . . . 662

Rutinas de la herramienta de gestión dealmacenamiento . . . . . . . . . . . . 664

ProcedimientoCAPTURE_STORAGEMGMT_INFO – Recuperarinformación relacionada con el almacenamientopara un objeto raíz concreto . . . . . . . 664ProcedimientoCREATE_STORAGEMGMT_TABLES - Creartablas de gestión de almacenamiento . . . . 665ProcedimientoDROP_STORAGEMGMT_TABLES – Eliminartodas las tablas de gestión de almacenamiento . 666

Rutinas de búsqueda de texto . . . . . . . . 667Procedimiento almacenadoSYSTS_ADMIN_CMD - Ejecutar mandatos deadministración de búsqueda de texto . . . . 667Procedimiento SYSTS_ALTER - Cambiar lascaracterísticas de actualización de un índice . . 668ProcedimientoSYSTS_CLEAR_COMMANDLOCKS - Eliminarbloqueos de mandato para índices de búsquedade texto . . . . . . . . . . . . . . 672Procedimiento SYSTS_CLEAR_EVENTS -Suprimir los sucesos de indexación de una tablade sucesos de índice . . . . . . . . . . 674Procedimiento SYSTS_CREATE - Crear uníndice de búsqueda de texto en una columna. . 676Procedimiento SYSTS_DISABLE - Inhabilitarbase de datos actual para búsqueda de textos . 683Procedimiento SYSTS_DROP - Descartar uníndice de búsqueda de texto . . . . . . . 686Procedimiento SYSTS_ENABLE - Habilitar basede datos actual para búsqueda de textos . . . 688Procedimiento SYSTS_UPDATE - Actualizar elíndice de búsqueda de texto . . . . . . . 690

Rutinas de gestión de cargas de trabajo. . . . . 692WLM_CANCEL_ACTIVITY - Cancelar unaactividad . . . . . . . . . . . . . . 692WLM_CAPTURE_ACTIVITY_IN_PROGRESS -Recopilar información para supervisor desucesos de actividades . . . . . . . . . 693WLM_COLLECT_STATS - Coleccionar yrestaurar estadísticas de gestión de carga detrabajo. . . . . . . . . . . . . . . 695WLM_GET_ACTIVITY_DETAILS - Devolverinformación detallada sobre una actividadespecífica . . . . . . . . . . . . . . 697Función de tabla WLM_GET_QUEUE_STATS -Devolver estadísticas de cola de umbral . . . 704WLM_GET_SERVICE_CLASS_AGENTS - Listaragentes en ejecución en una clase de servicio . . 708WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES- Lista de ocurrencias de carga de trabajo . . . 714

WLM_GET_SERVICE_SUBCLASS_STATS -Devolver estadísticas de subclases de servicio . 718WLM_GET_SERVICE_SUPERCLASS_STATS -Devolver estadísticas de superclases de servicio . 724WLM_GET_WORK_ACTION_SET_STATS -Devolver estadísticas de conjunto de acciones detrabajo. . . . . . . . . . . . . . . 726WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES- Devolver una lista de actividades . . . . . 727WLM_GET_WORKLOAD_STATS - Devolverestadísticas de carga de trabajo . . . . . . 732Procedimiento WLM_SET_CLIENT_INFO -Establecer información de cliente . . . . . . 734

Rutinas y vistas varias . . . . . . . . . . 736Procedimiento ADMIN_COPY_SCHEMA –Copiar un esquema específico y sus objetos . . 736Procedimiento ADMIN_DROP_SCHEMA -Eliminar un esquema específico y sus objetos. . 741ALTOBJ . . . . . . . . . . . . . . 743APPLICATION_ID . . . . . . . . . . 746Función de tabla COMPILATION_ENV –Recuperar elementos del entorno decompilación . . . . . . . . . . . . . 746Vista administrativa CONTACTGROUPS –Recuperar la lista de grupos de contactos . . . 749Vista administrativa CONTACTS - Recuperarlista de contactos . . . . . . . . . . . 750Vista administrativa DB_HISTORY – Recuperarinformación de archivos históricos . . . . . 751Vista administrativa DBPATHS – Recuperar víasde acceso de bases de datos . . . . . . . 756EXPLAIN_FORMAT_STATS . . . . . . . 761EXPLAIN_GET_MSGS . . . . . . . . . 765GET_DBSIZE_INFO . . . . . . . . . . 768Vista administrativa NOTIFICATIONLIST –Recuperar lista de contactos para notificación desalud . . . . . . . . . . . . . . . 770PD_GET_DIAG_HIST - Devolver registros de undeterminado recurso . . . . . . . . . . 771Vista administrativaPDLOGMSGS_LAST24HOURS y función detabla PD_GET_LOG_MSGS – Recuperarmensajes de determinación de problemas . . . 778Procedimiento REORGCHK_IX_STATS -Recuperar estadísticas de índice para evaluaciónde la reorganización . . . . . . . . . . 785Procedimiento REORGCHK_TB_STATS -Recuperar estadísticas de tabla para evaluaciónde la reorganización . . . . . . . . . . 787Funciones escalares SQLERRM – Recuperarinformación de mensajes de error . . . . . 789SYSINSTALLOBJECTS . . . . . . . . . 791MON_GET_FCM - Obtener métricas de FCM 792MON_GET_FCM_CONNECTION_LIST -Obtener detalles para todas las conexiones FCM. 793

Capítulo 4. Rutinas administrativas deSQL obsoletas y sus vistas o rutinasde sustitución . . . . . . . . . . . 795

Contenido vii

Tabla de función ADMIN_GET_TAB_INFO -Recuperar información de tamaño y estado paralas tablas . . . . . . . . . . . . . . . 799RGET_DB_CONFIG . . . . . . . . . . . 809GET_DBM_CONFIG . . . . . . . . . . . 810Función de tabla SNAP_GET_APPL – Recuperarinformación de instantáneas del grupo de datoslógico appl . . . . . . . . . . . . . . 811Función de tabla SNAP_GET_APPL_INFO –Recuperación de información de instantáneas delgrupo de datos lógico appl_info . . . . . . . 819Función de tabla SNAP_GET_BP – Recuperaciónde la información de instantáneas del grupo dedatos lógico bufferpool . . . . . . . . . . 826SNAP_GET_CONTAINER . . . . . . . . . 831SNAP_GET_DB . . . . . . . . . . . . 832Función de tabla SNAP_GET_DBM – Recuperaciónde la información de instantáneas del grupo dedatos lógicos dbm . . . . . . . . . . . . 841Función de tabla SNAP_GET_DB_V91 - Recuperarinformación de instantánea desde el grupo lógicodbase . . . . . . . . . . . . . . . . 844Función de tabla SNAP_GET_DYN_SQL_V91 -Recuperar información de la instantánea del grupode datos lógicos dynsql . . . . . . . . . . 856SNAP_GET_DYN_SQL . . . . . . . . . . 860SNAP_GET_STO_PATHS . . . . . . . . . 862SNAP_GET_TAB . . . . . . . . . . . . 863SNAP_GET_TBSP . . . . . . . . . . . . 864SNAP_GET_TBSP_PART . . . . . . . . . 868SNAPSHOT_AGENT . . . . . . . . . . . 870SNAPSHOT_APPL . . . . . . . . . . . 871SNAPSHOT_APPL_INFO . . . . . . . . . 877SNAPSHOT_BP . . . . . . . . . . . . 879SNAPSHOT_CONTAINER . . . . . . . . . 882SNAPSHOT_DATABASE . . . . . . . . . 883SNAPSHOT_DBM. . . . . . . . . . . . 890SNAPSHOT_DYN_SQL . . . . . . . . . . 892SNAPSHOT_FCM . . . . . . . . . . . . 894SNAPSHOT_FCMNODE . . . . . . . . . 895

SNAPSHOT_FILEW . . . . . . . . . . . 896SNAPSHOT_LOCK . . . . . . . . . . . 897SNAPSHOT_LOCKWAIT . . . . . . . . . 898SNAPSHOT_QUIESCERS . . . . . . . . . 899SNAPSHOT_RANGES . . . . . . . . . . 901SNAPSHOT_STATEMENT . . . . . . . . . 902SNAPSHOT_SUBSECT . . . . . . . . . . 904SNAPSHOT_SWITCHES . . . . . . . . . 906SNAPSHOT_TABLE . . . . . . . . . . . 908SNAPSHOT_TBREORG . . . . . . . . . . 909SNAPSHOT_TBS . . . . . . . . . . . . 910SNAPSHOT_TBS_CFG . . . . . . . . . . 913SQLCACHE_SNAPSHOT . . . . . . . . . 915RSYSINSTALLROUTINES . . . . . . . . . 917

Parte 2. Apéndices . . . . . . . . 919

Apéndice A. Visión general de lainformación técnica de DB2 . . . . . 921Biblioteca técnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 922Pedido de manuales de DB2 en copia impresa . . 924Visualización de la ayuda para estados de SQLdesde el procesador de línea de mandatos. . . . 925Acceso a diferentes versiones del Centro deinformación de DB2 . . . . . . . . . . . 926Visualización de temas en su idioma preferido enel Centro de información de DB2 . . . . . . . 926Actualización del Centro de información de DB2instalado en el sistema o en el servidor de intranet . 927Guías de aprendizaje de DB2 . . . . . . . . 928Información de resolución de problemas de DB2 929Términos y condiciones . . . . . . . . . . 929

Apéndice B. Avisos . . . . . . . . . 931

Índice. . . . . . . . . . . . . . . 935

viii Rutinas y vistas administrativas

Parte 1. Vistas y rutinas administrativas SQL

Las vistas y rutinas administrativas proporcionan una interfaz de programaprincipal fácil de utilizar para administrar DB2 mediante SQL. Incluyen unacolección de vistas incorporadas, funciones de tabla, procedimientos y funcionesescalares para realizar diversas tareas administrativas de DB2. Por ejemplo:reorganizar una tabla, capturar y recuperar datos del supervisor o recuperar el IDde 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.

© Copyright IBM Corp. 2006, 2010 1

2 Rutinas y vistas administrativas

Capítulo 1. 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 una función 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.


Capítulo 2. Vistas administrativas comparadas con funcionesde tablas

DB2 Versión 9.5 presenta vistas administrativas que ofrecen una interfaz deprogramación de aplicaciones fácil de usar para las funciones administrativas deDB2 a través de SQL.

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, _V95). 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 3. Vistas y rutinas administrativas de SQLsoportadas

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 8v Vistas y rutinas del planificador de tareas administrativas: Tabla 18 en la página

21v Comprobar rutinas y procedimientosTabla 3 en la página 8v Vistas y rutinas administrativas SQL del mantenimiento automático: Tabla 4 en

la página 8v Vistas y rutinas administrativas SQL de la configuración: Tabla 5 en la página 9v Procedimientos almacenados de la API de SQL común: Tabla 6 en la página 9v Entorno de vistas administrativas: Tabla 7 en la página 10v Rutinas administrativas SQL de instantáneas de salud: Tabla 8 en la página 10v Rutinas administrativas SQL de MQSeries: Tabla 9 en la página 12v Vistas y rutinas administrativas SQL de la seguridad: Tabla 10 en la página 13v Vistas y rutinas administrativas SQL de instantáneas: Tabla 11 en la página 13v Rutinas administrativas SQL de procedimientos SQL: Tabla 12 en la página 17v Rutinas administrativas SQL de redistribución paso a paso: Tabla 13 en la página

17v Rutinas administrativas SQL de herramientas de almacenamiento: Tabla 14 en la

página 18v Rutinas administrativas SQL de búsqueda de texto: Tabla 15 en la página 18v Rutinas de gestión de carga de trabajo: Tabla 16 en la página 18v Vistas y rutinas administrativas SQL diversas: Tabla 17 en la página 19

Tabla 1. Rutinas administrativas SQL de supervisión de actividad

Nombre de la rutina Esquema Descripción

AM_BASE_RPT_RECOMS

SYSPROC Esta función de tabla devuelve lasrecomendaciones para los informes deactividad que utiliza el supervisor deactividad.

AM_BASE_RPTSSYSPROC Esta función de tabla devuelve los informes

de actividad que utiliza el supervisor deactividad.

AM_DROP_TASKSYSPROC Este procedimiento suprime una tarea de

supervisión.

AM_GET_LOCK_CHN_TBSYSPROC Este procedimiento devuelve datos de la

cadena de bloqueo de aplicación en formatotabular.

AM_GET_LOCK_CHNSSYSPROC Este procedimiento visualiza las series de

bloqueo de una aplicación especificadautilizando una serie con formato.


Tabla 1. Rutinas administrativas SQL de supervisión de actividad (continuación)


AM_GET_LOCK_RPTSYSPROC Este procedimiento visualiza los detalles del

bloque de una aplicación.

AM_GET_RPTSYSPROC Este procedimiento visualiza los datos sobre

el supervisor de actividad para un informe.

AM_SAVE_TASKSYSPROC Este procedimiento crea o modifica una tarea

de supervisión.

Tabla 2. Procedimiento ADMIN_CMD almacenado y rutinas administrativas SQL asociadas


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.

ADMIN_GET_DBP_MEM_USAGESYSPROC Esta función obtiene el consumo total de

memoria de una instancia determinada.

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.

ADMINTABCOMPRESSINFO yADMIN_GET_TAB_COMPRESS_INFO

SYSPROC Esta función devuelve información decompresión para tablas, tablas de consultasmaterializadas (MQT) y tablas de jerarquía.

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.

Tabla 3. Comprobar rutinas y procedimientos

Nombre de la vista o rutina Esquema Descripción

AUDIT_ARCHIVE SYSPROC Este procedimiento y la función de tablaarchivan el registro de comprobación actual.

AUDIT_DELIM_EXTRACT SYSPROC Este procedimiento extrae datos de losregistros archivados de forma binaria y loscarga en archivos delimitados.

AUDIT_LIST_LOGS SYSPROC Este procedimiento devuelve una lista delos registros de comprobación archivadosen la vía de acceso especificada para la basede datos actual.

Tabla 4. Vistas y rutinas administrativas SQL del mantenimiento automático


AUTOMAINT_GET_POLICY SYSPROC Este procedimiento obtiene los valoresactuales del mantenimiento automático parala base de datos.


Tabla 4. Vistas y rutinas administrativas SQL del mantenimiento automático (continuación)


AUTOMAINT_GET_POLICYFILE SYSPROC Este procedimiento obtiene los valoresactuales del mantenimiento automático parala base de datos.

AUTOMAINT_SET_POLICY SYSPROC Este procedimiento establece los valores dela política de mantenimiento automáticopara la base de datos conectadaactualmente.

AUTOMAINT_SET_POLICYFILE SYSPROC Este procedimiento establece los valores delmantenimiento automático para la base dedatos conectada actualmente.

Tabla 5. Vistas y rutinas administrativas SQL de la configuración


DB_PARTITIONSSYSPROC Esta función de tabla devuelve el contenido

del archivo db2nodes.cfg en formato detabla.

DBCFGSYSIBMADM Esta vista administrativa devuelve

información sobre la configuración de labase de datos.

DBMCFGSYSIBMADM Esta vista administrativa devuelve

información sobre la configuración delgestor de bases de datos.

REG_VARIABLESSYSIBMADM Esta vista administrativa devuelve los

valores de registro de DB2 de todas lasparticiones de bases de datos.

Tabla 6. Procedimientos almacenados de la API de SQL comú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 GET_CONFIG

SYSPROC Este procedimiento recupera datos deconfiguración del servidor de datos,incluidos datos del archivo nodes.cfg, datosde configuración del gestor de bases dedatos, datos de configuración de la base dedatos y valores de registro de todas lasparticiones 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.

Capítulo 3. Vistas y rutinas soportadas 9

Tabla 6. Procedimientos almacenados de la API de SQL común (continuación)


Procedimiento SET_CONFIGSYSPROC Este procedimiento actualiza los parámetros

de configuración recuperados con elprocedimiento GET_CONFIG.

Tabla 7. Vistas administrativas del entorno

Nombre de vista Esquema Descripción

ENV_FEATURE_INFOSYSPROC Esta función de tabla devuelve información

sobre todas las características disponiblespara las que se necesita una licencia.

ENV_INST_INFOSYSIBMADM Esta vista administrativa devuelve

información acerca de la instancia actual.

ENV_PROD_INFOSYSIBMADM Esta vista administrativa devuelve

información acerca de los productos de basede datos DB2 instalados.

ENV_SYS_INFOSYSIBMADM Esta vista administrativa devuelve

información acerca del sistema.

ENV_SYS_RESOURCESSYSIBMADM Esta vista administrativa indica el sistema

operativo, la CPU, la memoria y demásinformación relacionada con el sistema

Tabla 8. Rutinas administrativas SQL de instantáneas de salud


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.

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.

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.

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.

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.

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.


Tabla 8. Rutinas administrativas SQL de instantáneas de salud (continuación)


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.

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.

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.

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.

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.

HEALTH_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).

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

HEALTH_GET_IND_DEFINITIONSYSPROC Esta función de tabla devuelve las

definiciones del indicador de salud.

HEALTH_HI_REC

SYSPROC Este procedimiento recupera un conjunto derecomendaciones que direccionan unindicador de salud en estado de alerta enun objeto DB2 determinado.

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.


Tabla 8. Rutinas administrativas SQL de instantáneas de salud (continuación)


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.

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 9. Rutinas administrativas SQL de MQSeries


MQPUBLISHDB2MQ, DB2MQ1C Esta función escalar publica datos en una

ubicación MQSeries.

MQREADDB2MQ, DB2MQ1C Esta función escalar devuelve un mensaje

de una ubicación MQSeries.

MQREADALLDB2MQ, DB2MQ1C Esta función de tabla devuelve una tabla

con mensajes y metadatos de mensajes deuna ubicación MQSeries.

MQREADALLCLOB

DB2MQ Esta función de tabla devuelve una tablaque contiene mensajes y metadatos demensajes desde una ubicación MQSeriesespecificada.

MQREADCLOBDB2MQ Esta función escalar devuelve un mensaje

de una ubicación MQSeries especificada.

MQRECEIVEDB2MQ, DB2MQ1C Esta función escalar devuelve un mensaje

de una ubicación MQSeries y suprime elmensaje de la cola asociada.

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.

MQRECEIVEALLCLOB

DB2MQ Esta función de tabla devuelve una tablaque contiene mensajes y metadatos demensajes desde una ubicación MQSeriesespecificada.

MQRECEIVECLOBDB2MQ Esta función escalar devuelve un mensaje

de una ubicación MQSeries especificada.

MQSENDDB2MQ, DB2MQ1C Esta función escalar envía datos a una

ubicación MQSeries.

MQSUBSCRIBEDB2MQ, DB2MQ1C Esta función escalar suscribe a los mensajes

MQSeries publicados sobre un temaespecífico.

MQUNSUBSCRIBEDB2MQ, DB2MQ1C Esta función escalar cancela la suscripción a

los mensajes MQSeries publicados sobre untema específico.


Tabla 10. Vistas y rutinas administrativas SQL de la seguridad:


AUTH_LIST_AUTHORITIES_FOR_AUTHID

SYSPROC Esta función 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 una función.

AUTH_LIST_GROUPS_FOR_AUTHIDSYSPROC Esta función de tabla devuelve la lista de

grupos de los que es miembro el ID deautorización determinado.

AUTH_LIST_ROLES_FOR_AUTHIDSYSPROC Esta función devuelve la lista de funciones

de los que es miembro el ID deautorización determinado.

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.

OBJECTOWNERS

SYSIBMADM Esta vista administrativa contiene toda lainformación sobre la propiedad de objetoscorrespondiente a la base de datosconectada actualmente.

PRIVILEGESSYSIBMADM Esta vista administrativa contiene todos los

privilegios explícitos correspondientes a labase de datos conectada actualmente.

Tabla 11. Vistas y rutinas administrativas SQL de instantáneas


APPLICATIONSSYSIBMADM Esta vista administrativa devuelve

información sobre las aplicaciones de basede datos conectadas.

APPL_PERFORMANCE

SYSIBMADM Esta vista administrativa muestrainformación acerca del índice filasseleccionado en comparación con las filasleídas por aplicación.

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.

BP_READ_IO

SYSIBMADM Esta vista administrativa devuelveinformación sobre el rendimiento de lecturade la agrupación de almacenamientosintermedios.

BP_WRITE_IO

SYSIBMADM Esta vista administrativa devuelveinformación sobre el rendimiento degrabación de cada agrupación dealmacenamientos intermedios.

CONTAINER_UTILIZATION

SYSIBMADM Esta vista administrativa devuelveinformación acerca de los contenedores deespacios de tablas y los índices deutilización.


Tabla 11. Vistas y rutinas administrativas SQL de instantáneas (continuación)


LOCKS_HELDSYSIBMADM Esta vista administrativa devuelve

información sobre los bloqueos actuales.

LOCKWAITSSYSIBMADM Esta vista administrativa devuelve

información sobre los bloqueos que están ala espera de ser concedidos.

LOG_UTILIZATION

SYSIBMADM Esta vista administrativa devuelveinformación sobre la utilización de lasanotaciones cronológicas para la base dedatos conectada actualmente.

LONG_RUNNING_SQLSYSIBMADM Esta vista administrativa devuelve las

sentencias SQL de ejecución más larga de labase de datos conectada actualmente.

QUERY_PREP_COSTSYSIBMADM Esta vista administrativa devuelve una lista

de las sentencias con información acerca deltiempo necesario para preparar la sentencia.

SNAP_WRITE_FILE

SYSPROC Este procedimiento graba datos deinstantánea del sistema en un archivoubicado en el subdirectorio tmp deldirectorio de la instancia.

SNAPAGENT y 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.

SNAPAGENT_MEMORY_POOL ySNAP_GET_AGENT_MEMORY_POOL


La vista administrativa y la función detabla devuelven información acerca del usode la memoria a nivel de agente.

SNAPAPPL y SNAP_GET_APPL_V95


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.

SNAPAPPL_INFO ySNAP_GET_APPL_INFO_V95


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.

SNAPBP y SNAP_GET_BP_V95


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.

SNAPBP_PART y SNAP_GET_BP_PART


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.




SNAPCONTAINER ySNAP_GET_CONTAINER_V91


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.

SNAPDB y SNAP_GET_DB_V95


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

SNAPDB_MEMORY_POOL ySNAP_GET_DB_MEMORY_POOL


Esta vista administrativa y función de tabladevuelven información acerca del uso de lamemoria en la base de datos sólo parasistemas operativos UNIX®.

SNAPDBM y SNAP_GET_DBM_V95


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.

SNAPDBM_MEMORY_POOL ySNAP_GET_DBM_MEMORY_POOL


Esta vista administrativa y función de tabladevuelven información acerca del uso de lamemoria en el gestor de bases de datos.

SNAPDETAILLOG ySNAP_GET_DETAILLOG_V91


Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos detail_log.

SNAPDYN_SQL y SNAP_GET_DYN_SQL_V95


Esta vista administrativa y función de tabladevuelven información de las instantáneasa partir del grupo de datos lógicos dynsql.

SNAPFCM y SNAP_GET_FCM


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.

SNAPFCM_PART y SNAP_GET_FCM_PART


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.

SNAPHADR y SNAP_GET_HADR


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.

SNAPLOCK y SNAP_GET_LOCK


Esta vista administrativa y función de tabladevuelven información de instantáneasacerca de los bloqueos, en concreto el grupode datos lógicos lock.




SNAPLOCKWAIT y SNAP_GET_LOCKWAIT


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.


Esta vista administrativa y funcióndevuelven información acerca de lassentencias de una instantánea de aplicación.

SNAPSTORAGE_PATHS ySNAP_GET_STORAGE_PATHS


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.

SNAPSUBSECTION ySNAP_GET_SUBSECTION


Esta vista administrativa y función de tabladevuelven información sobre lassubsecciones de aplicaciones, concretamentela agrupación del supervisor lógicosubsection.


Esta vista administrativa y función de tabladevuelven información acerca del estadodel conmutador de instantánea de base dedatos.

SNAPTAB y SNAP_GET_TAB_V91


Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos table.

SNAPTAB_REORG ySNAP_GET_TAB_REORG


Esta vista administrativa y función de tabladevuelven información acerca de lareorganización de tabla.

SNAPTBSP y SNAP_GET_TBSP_V91


Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos table space.

SNAPTBSP_PART ySNAP_GET_TBSP_PART_V91


Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicostablespace_nodeinfo.

SNAPTBSP_QUIESCER ySNAP_GET_TBSP_QUIESCER


Esta vista administrativa y función de tabladevuelven información acerca de losinmovilizadores desde una instantánea delespacio de tablas.

SNAPTBSP_RANGE ySNAP_GET_TBSP_RANGE


Esta vista administrativa y función de tabladevuelven información de una instantáneade rango.

SNAPUTIL y SNAP_GET_UTIL


Esta vista administrativa y función de tabladevuelven información de las instantáneasdel grupo de datos lógicos utility_info.




SNAPUTIL_PROGRESS ySNAP_GET_UTIL_PROGRESS


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.

TBSP_UTILIZATIONSYSIBMADM Esta vista administrativa devuelve

información de utilización y configuraciónde espacio de tablas.

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.

Tabla 12. Rutinas administrativas SQL de procedimientos SQL


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.

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.

PUT_ROUTINE_SARSYSFUN Este procedimiento pasa la información

necesaria para crear y definir una rutinaSQL en el servidor de bases de datos.

REBIND_ROUTINE_PACKAGESYSPROC Este procedimiento vuelve a vincular el

paquete asociado con un procedimiento deSQL.

SET_ROUTINE_OPTSSYSPROC Este procedimiento establece las opciones

que deben utilizarse para la creación deprocedimientos SQL en la sesión actual.

Tabla 13. Rutinas administrativas SQL de redistribución paso a paso


ANALYZE_LOG_SPACESYSPROC Este procedimiento devuelve información

de análisis del espacio de anotacionescronológicas.

GENERATE_DISTFILESYSPROC Este procedimiento genera un archivo de

distribución de datos.

GET_SWRD_SETTINGSSYSPROC Este procedimiento devuelve información

de redistribución.

SET_SWRD_SETTINGSSYSPROC Este procedimiento crea o modifica el

registro de redistribución.

STEPWISE_REDISTRIBUTE_DBPGSYSPROC Este procedimiento redistribuye parte de

un grupo de particiones de base de datos.


Tabla 14. Rutinas administrativas SQL de la herramienta de administración del almacenamiento


CAPTURE_STORAGEMGMT_INFOSYSPROC Este procedimiento devuelve información

relacionada con el almacenamiento de unobjeto raíz concreto.

CREATE_STORAGEMGMT_TABLESSYSPROC Este procedimiento crea tablas de gestión

de almacenamiento.

DROP_STORAGEMGMT_TABLESSYSPROC Este procedimiento inactiva las tablas de

gestión de almacenamiento.

Tabla 15. Rutinas administrativas SQL de búsqueda de texto


SYSTS_ADMIN_CMDSYSPROC Este procedimiento ejecuta mandatos

administrativos de búsqueda de textoutilizando la sentencia SQL CALL.

SYSTS_ALTERSYSPROC Este procedimiento cambia las

características de actualización de uníndice.

SYSPROC Este procedimiento elimina todos losbloqueos de mandatos para un índice debúsqueda de texto específico o para todoslos índices de búsqueda de texto en la basede datos.

SYSTS_CLEAR_EVENTSSYSPROC Este procedimiento suprime los sucesos de

indexación de una tabla de sucesos deíndice utilizados para la administración.

SYSTS_CREATE

SYSPROC Este procedimiento crea un índice debúsqueda de textos para una columna detexto que permite que se efectúenbúsquedas en los datos de la columnautilizando las funciones de búsqueda detexto.

SYSTS_DISABLESYSPROC Este procedimiento inhabilita la búsqueda

de texto de DB2 para la base de datosactual.

SYSTS_DROPSYSPROC Este procedimiento descarta un índice de

búsqueda de texto existente asociado acualquier columna de tabla.

SYSTS_ENABLE

SYSPROC Este procedimiento debe emitirse de modosatisfactorio antes de que puedan crearseíndices de búsqueda de texto en lascolumnas de las tablas de la base de datos.

SYSTS_UPDATE

SYSPROC Este procedimiento actualiza el índice debúsqueda de textos para reflejar elcontenido actual de las columnas de texto alas que está asociado el índice.

Tabla 16. Rutinas administrativas SQL de la herramienta de mantenimiento automático


WLM_CANCEL_ACTIVITY SYSPROC Este procedimiento cancela la actividad dada.


Tabla 16. Rutinas administrativas SQL de la herramienta de mantenimiento automático (continuación)


WLM_CAPTURE_ACTIVITY_IN_PROGRESS SYSPROC Este procedimiento envía información de unaactividad determinada al supervisor deeventos de actividades.

WLM_COLLECT_STATS SYSPROC Este procedimiento envía estadísticas paraclases de servicio, cargas de trabajo, clases detrabajo y colas de umbral al supervisor deeventos de estadísticas y restaura la copia enmemoria de las estadísticas.

WLM_GET_ACTIVITY_DETAILS SYSPROC Esta función devuelve información detalladasobre una actividad específica identificadapor su APPLICATION_HANDLE, UOW_IDy ACTIVITY_ID.

WLM_GET_QUEUE_STATS SYSPROC Esta función devuelve información estadísticabásica de una o más colas de umbral.

WLM_GET_SERVICE_CLASS_AGENTS SYSPROC Esta función devuelve la lista de agentes enla partición dada que ejecutan en la clase deservicio SERVICE_SUPERCLASS_NAME ySERVICE_SUBCLASS_NAME o en nombrede la aplicación dada porAPPLICATION_HANDLE.

WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES SYSPROC Esta función devuelve la lista de todas lasocurrencias de carga de trabajo ejecutadas enuna clase de servicio dada en una particióndeterminada.

WLM_GET_SERVICE_SUBCLASS_STATS SYSPROC Esta función devuelve las estadísticas básicasde una o más subclases de servicio.

WLM_GET_SERVICE_SUPERCLASS_STATS SYSPROC Esta función devuelve las estadísticas básicasde una o más superclases de servicio.

WLM_GET_WORK_ACTION_SET_STATS SYSPROC Esta función devuelve las estadísticas básicasde clases de trabajo en un conjunto deacciones de trabajo.

WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES SYSPROC Esta función devuelve la lista de todas lasactividades sometidas mediante la aplicacióndada en la partición especificada y quetodavía no se han completado.

WLM_GET_WORKLOAD_STATS SYSPROC Esta función devuelve las estadísticas básicasde una o más cargas de trabajo.

WLM_SET_CLIENT_INFO SYSPROC Este procedimiento establece información decliente asociada con la conexión actual en elservidor de base de datos DB2.

Tabla 17. Vistas y rutinas administrativas SQL varias


ADMIN_COPY_SCHEMASYSPROC Este procedimiento sirve para copiar un

esquema específico y todos los objetoscontenidos en el mismo.

ADMIN_DROP_SCHEMASYSPROC Este procedimiento sirve para desactivar un

esquema específico y todos los objetoscontenidos en el mismo.

ADMINTABINFO yADMIN_GET_TAB_INFO_V95

SYSIBMADM (vistaadministrativa),SYSPROC (funciónde tabla)

Esta vista administrativa y función de tabladevuelven información de tamaño y estadopara las tablas, las tablas de consultasmaterializadas (MQT) y las tablas dejerarquía.


Tabla 17. Vistas y rutinas administrativas SQL varias (continuación)


ALTOBJ

SYSPROC Este procedimiento altera una tablaexistente utilizando la sentencia CREATETABLE de entrada como la definición detabla de destino.

APPLICATION_IDSYSFUN Esta función escalar devuelve el ID de

aplicación de la conexión actual.

COMPILATION_ENVSYSPROC Esta función de tabla devuelve los

elementos de un entorno de compilación.

CONTACTGROUPSSYSIBMADM Esta vista administrativa devuelve

información acerca de la lista de contactos.

CONTACTSSYSIBMADM La vista administrativa devuelve la lista de

contactos definidos en el servidor de basesde datos.

DB_HISTORYSYSIBMADM Esta administrativa devuelve información

del archivo histórico asociado a la particiónde base de datos conectada actualmente.

DBPATHS

SYSIBMADM Esta vista administrativa devuelve losvalores de las vías de acceso de bases dedatos necesarias para tareas como dividircopias de seguridad duplicadas.

EXPLAIN_FORMAT_STATS

SYSPROC La nueva función escalar se usa paramostrar información estadística formateadaanalizada y extraída de una instantánea deexplicación capturada para una consultadeterminada.

EXPLAIN_GET_MSGS

El esquema es elmismo que el de latabla Explain.

Esta función de tabla consulta las tablasExplain de EXPLAIN_DIAGNOSTIC yEXPLAIN_DIAGNOSTIC_DATA ydevuelve mensajes con formato.

GET_DBSIZE_INFOSYSPROC Este procedimiento calcula el tamaño de

base de datos y la capacidad máxima.

PD_GET_DIAG_HISTSYSPROC La función devuelve registros de anotación

cronológica, registros de sucesos y registrosde notificación de un recurso determinado.

NOTIFICATIONLIST

SYSIBMADM Esta vista administrativa devuelve la listade contactos y grupos de contactos a losque se notifica sobre la salud de unainstancia.

PDLOGMSGS_LAST24HOURS

SYSIBMADM (vistaadministrativa),SYSPROC (funciónde tabla)

La vista administrativa y la función detabla devuelven mensajes de anotacionescronológicas de determinación deproblemas que se han registrado en lasanotaciones cronológicas de notificacionesde DB2. La información está destinada a losadministradores de bases de datos y delsistema.

REORGCHK_IX_STATSSYSPROC Este procedimiento comprueba las

estadísticas del índice para determinar si eso no es necesaria una reorganización.


Tabla 17. Vistas y rutinas administrativas SQL varias (continuación)


REORGCHK_TB_STATSSYSPROC Este procedimiento comprueba las

estadísticas de la tabla para determinar sies o no es necesaria una reorganización.

SQLERRM

SYSPROC Esta función escalar tiene dos versiones. Laprimera ofrece flexibilidad completa en larecuperación de mensajes, incluidossímbolos de mensajes y selección deidioma. La segunda es una sencilla interfazque toma únicamente un SQLCODE comoparámetro de entrada y devuelve elmensaje abreviado en inglés.

SYSINSTALLOBJECTSSYSPROC El procedimiento crea o descarta los objetos

de base de datos requeridos para unaherramienta específica.

MON_GET_FCMSYSPROC Esta función de tabla devuelve métricas

para el gestor de comunicaciones rápidas(FCM).

MON_GET_FCM_CONNECTION_LIST

SYSPROC Esta función de tabla devuelve métricas delsupervisor para todas las conexiones delgestor de comunicaciones rápidas (FCM) enlos miembros especificados.

Tabla 18. Vistas y rutinas del planificador de tareas administrativas


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

Rutinas del supervisor de actividades

AM_BASE_RPT_RECOMS – Recomendaciones para informesde actividad

La función de tabla AM_BASE_RPT_RECOMS devuelve recomendaciones para losinformes de actividad utilizados por el supervisor de actividad.

Sintaxis

�� AM_BASE_RPT_RECOMS ( id-informe , entorno-local-cliente ) ��


El esquema es SYSPROC.

Parámetros de la función de tabla

id-informeArgumento de entrada de tipo INTEGER que especifica un ID de informe. Si elargumento es nulo, se devuelven recomendaciones para todos los informesdisponibles.

entorno-local-clienteArgumento de entrada de tipo VARCHAR(33) que especifica el identificadordel idioma del cliente. Si el argumento es nulo o una serie vacía, el valor poromisión es 'En_US' (inglés). Si los archivos de mensajes del entorno localespecificado no están disponibles en el servidor, se utilizará 'En_US'.

Autorización

Privilegio EXECUTE para la función de tabla AM_BASE_RPT_RECOMS.

Ejemplos

Ejemplo 1: Solicite recomendaciones (en inglés) para el informe del supervisor deactividad con el ID nº 1. Suponga que el identificador del idioma del cliente poromisión es 'En_US'.SELECT *

FROM TABLE(SYSPROC.AM_BASE_RPT_RECOMS(1, CAST(NULL AS VARCHAR(33))))AS RECOMS

Ejemplo 2: Solicite recomendaciones (en francés) para el informe del supervisor deactividad con el ID nº 12.SELECT *

FROM TABLE(SYSPROC.AM_BASE_RPT_RECOMS(12, CAST(’Fr_FR’ AS VARCHAR(33))))AS RECOMS

Información devuelta

Tabla 19. Información devuelta por la función de tabla AM_BASE_RPT_RECOMS

Nombre de columna Tipo de datos Descripción

REPORT_ID INTEGER El ID de informe.

RECOM_NAME VARCHAR(256) El nombre o descripciónabreviada de larecomendación.

RECOM_DESCRIPTION CLOB(32K) La descripción detallada de larecomendación.

AM_BASE_RPTS – Informes del supervisor de actividad

La función de tabla AM_BASE_RPTS devuelve informes de actividad utilizadospor el supervisor de actividad.

Sintaxis

�� AM_BASE_RPTS ( id-informe , tipo , entorno-local-cliente ) ��



Parámetros de la función de tabla

id-informeArgumento de entrada de tipo INTEGER que especifica un ID de informeexclusivo. Si el argumento es nulo, se devolverán informes con cualquier ID deinforme.

tipoArgumento de entrada de tipo CHAR(4) que especifica el tipo de informe. Losvalores válidos son:

'APPL'Aplicación

'STMT'Sentencia de SQL

'TRAN'Transacción

'CACH'Antememoria de sentencias de SQL dinámico

Los valores se pueden especificar en caracteres en mayúsculas o minúsculas. Siel argumento es nulo o una serie vacía, se devuelven informes de cualquiertipo.

entorno-local-clienteArgumento de entrada de tipo VARCHAR(33) que especifica el identificadordel idioma del cliente. Si el argumento es nulo o una serie vacía o los archivosde mensajes del entorno local especificado no están disponibles en el servidor,se utiliza 'En_US'.

Autorización

Privilegio EXECUTE para la función de tabla AM_BASE_RPTS.

Ejemplos

Ejemplo 1:SELECT * FROM TABLE(SYSPROC.AM_BASE_RPTS(CAST(NULL AS INTEGER),

CAST(NULL AS CHAR(4)), CAST(NULL AS VARCHAR(33)))) AS REPORTS

Ejemplo 2:SELECT ID, NAME FROM TABLE(SYSPROC.AM_BASE_RPTS(

CAST(NULL AS INTEGER), CAST(’STMT’ AS CHAR(4)), ’En_US’))AS REPORTS WHERE TYPE = ’STMT’


Tabla 20. Información devuelta por la función de tabla AM_BASE_RPTS


ID INTEGER El ID de informe exclusivo.

TYPE CHAR(4) El tipo de informe. Losvalores válidos son: APPL,STMT, TRAN, CACH.


Tabla 20. Información devuelta por la función de tabla AM_BASE_RPTS (continuación)


NAME VARCHAR(256) El nombre o descripciónabreviada del informe.

DESCRIPTION VARCHAR(16384) La descripción detallada delinforme.

SWITCHES VARCHAR(100) Los conmutadores desupervisor necesarios paraeste informe.

RAM_DROP_TASK – Supresión de una tarea de supervisión

El procedimiento AM_DROP_TASK suprime una tarea de supervisión. Nodevuelve ningún dato.

Sintaxis

�� AM_DROP_TASK ( id-tarea ) ��


Parámetro del procedimiento

id-tareaArgumento de entrada de tipo INTEGER que especifica un ID de tarea desupervisión exclusivo.

Autorización

Privilegio EXECUTE para el procedimiento AM_DROP_TASK.

Ejemplo

Descartar la tarea de supervisión con el ID 5.CALL SYSPROC.AM_DROP_TASK(5)

RAM_GET_LOCK_CHN_TB – Recuperación de los datos de lacadena de bloqueo de la aplicación en formato tabular

El procedimiento AM_GET_LOCK_CHN_TB devuelve datos de cadena de bloqueode aplicación en formato tabular. Una cadena de bloqueo se compone de todas lasaplicaciones que mantiene o espera la aplicación actual, directa o indirectamente.

Sintaxis

�� AM_GET_LOCK_CHN_TB ( id-agente ) ��



Parámetro del procedimiento

id-agenteArgumento de entrada de tipo BIGINT que especifica el ID de agente de laaplicación para la que se deben recuperar datos de cadena de bloqueo.

Autorizaciónv Autorización SYSMONv Privilegio EXECUTE para el procedimiento AM_GET_LOCK_CHN_TB.

Ejemplo

Recuperar información de cadena de bloqueo para el ID de agente 68.CALL SYSPROC.AM_GET_LOCK_CHN_TB(68)


El procedimiento devuelve una tabla tal como se muestra más abajo. Cada fila dela tabla representa una relación de bloqueo-espera. El conjunto de resultadostambién contiene una fila para cada aplicación de sólo mantenimiento; en estecaso, la columna HOLDING_AGENT_ID es nula y las otras cuatro columnas sonpara la aplicación de sólo mantenimiento.

Tabla 21. Información devuelta por el procedimiento AM_GET_LOCK_CHN_TB


HOLDING_AGENT_ID BIGINT El ID de agente de la aplicaciónque mantiene el bloqueo.

AGENT_ID BIGINT El ID de agente de la aplicaciónque espera el bloqueo.

APPL_NAME VARCHAR(255) El nombre de la aplicación queespera el bloqueo.

AUTH_ID VARCHAR(128) El ID de autorización de laaplicación que espera el bloqueo.

APPL_ID VARCHAR(64) El ID de la aplicación que espera elbloqueo.

RAM_GET_LOCK_CHNS – Recuperación de información debloqueo de cadenas para una aplicación específica

El procedimiento AM_GET_LOCK_CHNS devuelve cadenas de bloqueo para laaplicación especificada como una serie formateada. Una cadena de bloqueo secompone de todas las aplicaciones que mantiene o espera la aplicación actual,directa o indirectamente.

Sintaxis

�� AM_GET_LOCK_CHNS ( id-agente , cadenas-bloqueo ) ��



Parámetros del procedimiento

id-agenteArgumento de entrada de tipo BIGINT que especifica el ID de agente de laaplicación cuyas cadenas de bloqueo se deben visualizar.

cadenas-bloqueoArgumento de salida de tipo CLOB(2M) que muestra todas las cadenas debloqueo para la aplicación especificada.

Autorizaciónv Autorización SYSMONv Privilegio EXECUTE para el procedimiento AM_GET_LOCK_CHNS.

EjemploCALL SYSPROC.AM_GET_LOCK_CHNS(17,?)

Value of output parameters--------------------------Parameter Name : LOCK_CHAINSParameter Value : >db2bp.exe (Agent ID: 17) (Auth ID: AMUSERC )


El procedimiento devuelve tres conjuntos de resultados: uno para informacióngeneral de la aplicación; otro para los bloqueos retenidos por la aplicación y otropara los bloqueos que la aplicación está esperando.

Tabla 22. Información general de aplicación devuelta por el procedimientoAM_GET_LOCK_RPT


AGENT_ID BIGINT agent_id - Descriptor de contextode aplicación (ID de agente)

APPL_NAME VARCHAR(256) appl_name - Nombre de laaplicación

AUTH_ID VARCHAR(128) auth_id - ID de autorización

APPL_ID VARCHAR(128) appl_id - ID de aplicación

APPL_STATUS VARCHAR(22) appl_status - Estado de aplicación.Esta interfaz devuelve unidentificador de texto basado en lassentencias define de sqlmon.h, y esuno de los siguientes:

v BACKUPv COMMIT_ACTv COMPv CONNECTEDv CONNECTPENDv CREATE_DBv DECOUPLEDv DISCONNECTPENDv INTRv IOERROR_WAITv LOADv LOCKWAITv QUIESCE_TABLESPACEv RECOMPv REMOTE_RQSTv RESTARTv RESTOREv ROLLBACK_ACTv ROLLBACK_TO_SAVEPOINTv TENDv THABRTv THCOMTv TPREPv UNLOADv UOWEXECv UOWWAITv WAITFOR_REMOTE

COORD_PARTITION_NUM SMALLINT coord_node - Nodo decoordinación


Tabla 22. Información general de aplicación devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


SEQUENCE_NO VARCHAR(4) sequence_no - Número desecuencia

CLIENT_PRDID VARCHAR(128) client_prdid - ID deproducto/versión del cliente

CLIENT_PID BIGINT client_pid - ID de proceso decliente

CLIENT_PLATFORM VARCHAR(12) client_platform - Plataformaoperativa de cliente. Esta interfazdevuelve un identificador de textobasado en las sentencias define desqlmon.h,

v AIXv AIX64v AS400_DRDAv DOSv DYNIXv HPv HP64v HPIAv HPIA64v LINUXv LINUX390v LINUXIA64v LINUXPPCv LINUXPPC64v LINUXX8664v LINUXZ64v MACv MVS_DRDAv NTv NT64v OS2v OS390v SCOv SGIv SNIv SUNv SUN64v UNKNOWNv UNKNOWN_DRDAv VM_DRDAv VSE_DRDAv WINDOWSv WINDOWS95


Tabla 22. Información general de aplicación devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


CLIENT_PROTOCOL VARCHAR(10) client_protocol - Protocolo decomunicaciones de cliente. Estainterfaz devuelve un identificadorde texto basado en las sentenciasdefine de sqlmon.h,

v CPICv LOCALv NETBIOSv NPIPEv TCPIP (para DB2 Universal

Database o DB2 UDB)

v TCPIP4v TCPIP6

CLIENT_NNAME VARCHAR(128) El elemento del supervisorclient_nname está obsoleto. El valordevuelto no es un valor válido.

LOCKS_HELD BIGINT locks_held - Bloqueos retenidos

LOCK_WAIT_START_TIME TIMESTAMP lock_wait_start_time - Indicaciónde fecha y hora de inicio de esperade bloqueo

LOCK_WAIT_TIME BIGINT lock_wait_time - Tiempo esperadoen bloqueos

LOCK_WAITS BIGINT lock_waits - Esperas de bloqueo

LOCK_TIMEOUTS BIGINT lock_timeouts - Número de tiemposde espera de bloqueo

LOCK_ESCALS BIGINT lock_escals - Número deescalamientos de bloqueo

X_LOCK_ESCALS BIGINT x_lock_escals - Escalas de bloqueoexclusivas

DEADLOCKS BIGINT deadlocks - Puntos muertosdetectados

Tabla 23. Información retenida por los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT


TBSP_NAME VARCHAR(128) tablespace_name - Nombre deespacio de tablas

TABSCHEMA VARCHAR(128) table_schema - Nombre deesquema de tabla

TABNAME VARCHAR(128) table_name - Nombre de tabla


Tabla 23. Información retenida por los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


LOCK_OBJECT_TYPE VARCHAR(18) lock_object_type - Tipo de objeto debloqueo esperado. Esta interfazdevuelve un identificador de textobasado en las sentencias define desqlmon.h y es uno de lossiguientes:

v AUTORESIZE_LOCKv AUTOSTORAGE_LOCKv BLOCK_LOCKv EOT_LOCKv INPLACE_REORG_LOCKv INTERNAL_LOCKv INTERNALB_LOCKv INTERNALC_LOCKv INTERNALJ_LOCKv INTERNALL_LOCKv INTERNALO_LOCKv INTERNALQ_LOCKv INTERNALP_LOCKv INTERNALS_LOCKv INTERNALT_LOCKv INTERNALV_LOCKv KEYVALUE_LOCKv ROW_LOCKv SYSBOOT_LOCKv TABLE_LOCKv TABLE_PART_LOCKv TABLESPACE_LOCKv XML_PATH_LOCK


Tabla 23. Información retenida por los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


LOCK_MODE VARCHAR(10) lock_mode - Modalidad debloqueo. Esta interfaz devuelve unidentificador de texto basado en lassentencias define de sqlmon.h y esuno de los siguientes:

v INv ISv IXv NON (si no existe bloqueo)v NSv NWv NXv Sv SIXv Uv Wv Xv Z

LOCK_STATUS VARCHAR(10) lock_status - Estado de bloqueo.Esta interfaz devuelve unidentificador de texto basado en lassentencias define de sqlmon.h y esuno de los siguientes:

v CONVv GRNT

LOCK_ESCALATION SMALLINT lock_escalation - Escalamiento debloqueo

LOCK_NAME VARCHAR(32) lock_name - Nombre de bloqueo

DBPARTITIONNUM SMALLINT La partición de base de datos desdela que se han recuperado los datospara esta fila.

Tabla 24. Información de espera de los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT


AGENT_ID_HOLDING_LK BIGINT agent_id_holding_lock - ID deagente que mantiene el bloqueo

APPL_ID_HOLDING_LK VARCHAR(128) appl_id_holding_lk - ID deaplicación que mantiene el bloqueo

LOCK_WAIT_START_TIME TIMESTAMP lock_wait_start_time - Indicaciónde fecha y hora de inicio de esperade bloqueo

DBPARTITIONNUM SMALLINT La partición de base de datos desdela que se han recuperado los datospara esta fila.

TBSP_NAME VARCHAR(128) tablespace_name - Nombre deespacio de tablas


Tabla 24. Información de espera de los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


TABSCHEMA VARCHAR(128) table_schema - Nombre deesquema de tabla

TABNAME VARCHAR(128) table_name - Nombre de tabla

LOCK_OBJECT_TYPE VARCHAR(18) lock_object_type - Tipo de objeto debloqueo esperado. Esta interfazdevuelve un identificador de textobasado en las sentencias define desqlmon.h y es uno de lossiguientes:

v AUTORESIZE_LOCKv AUTOSTORAGE_LOCKv BLOCK_LOCKv EOT_LOCKv INPLACE_REORG_LOCKv INTERNAL_LOCKv INTERNALB_LOCKv INTERNALC_LOCKv INTERNALJ_LOCKv INTERNALL_LOCKv INTERNALO_LOCKv INTERNALQ_LOCKv INTERNALP_LOCKv INTERNALS_LOCKv INTERNALT_LOCKv INTERNALV_LOCKv KEYVALUE_LOCKv ROW_LOCKv SYSBOOT_LOCKv TABLE_LOCKv TABLE_PART_LOCKv TABLESPACE_LOCKv XML_PATH_LOCK


Tabla 24. Información de espera de los bloqueos devuelta por el procedimientoAM_GET_LOCK_RPT (continuación)


LOCK_MODE VARCHAR(10) lock_mode - Modalidad debloqueo. Esta interfaz devuelve unidentificador de texto basado en lassentencias define de sqlmon.h y esuno de los siguientes:


LOCK_MODE_REQUESTED VARCHAR(10) lock_mode_requested - Modalidadde bloqueo solicitada. Esta interfazdevuelve un identificador de textobasado en las sentencias define desqlmon.h y es uno de lossiguientes:


LOCK_ESCALATION SMALLINT lock_escalation - Escalamiento debloqueo

RAM_GET_RPT – Recuperación de datos del supervisor deactividad

El procedimiento AM_GET_RPT devuelve datos del supervisor de actividad paraun informe.


Sintaxis

�� AM_GET_R

Documents

public.dhe.ibm.compublic.dhe.ibm.com/ps/products/db2/info/vr95/pdf/es_ES/DB2Admin... · EALTH_CONT_HI ..........272 HEALTH_CONT_HI_HIS ........274 HEALTH_CONT_INFO .........276 HEALTH_DB_HI