rutinas y vistas administrativaspublic.dhe.ibm.com/ps/products/db2/info/vr101/pdf/es_es/...una...

IBM DB2 10.1para Linux, UNIX y Windows

Rutinas y vistas administrativasActualizado en enero de 2013

SC11-8068-01

��

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

Nota de edición

Este manual es la traducción del original en inglés IBM DB2 10.1 for Linux, UNIX, and Windows AdministrativeRoutines and Views Updated January, 2013 (SC27-3865-01).

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

publications/order

v Para encontrar al representante local de IBM que le corresponde, vaya a la sección Worlwide Contacts de IBMDirectory en http://www.ibm.com/planetwide/

Para realizar pedidos de publicaciones de DB2 desde DB2 Marketing and Sales, en los EE.UU. o en Canadá, llameal 1-800-IBM-4YOU (426-4968).

Cuando envía información a IBM, está otorgando a IBM el derecho no exclusivo de utilizar o distribuir lainformación de cualquier forma que considere adecuada sin incurrir por ello a ninguna obligación para con usted.

© Copyright IBM Corporation 2006, 2013.

http://www.ibm.com/shop/publications/orderhttp://www.ibm.com/shop/publications/orderhttp://www.ibm.com/planetwide/

Contenido

Vistas y rutinas incorporadas . . . . . 1Recomendaciones para llamar a rutinas y vistasincorporadas en aplicaciones . . . . . . . . . 1Autorizaciones para utilizar vistas y rutinasincorporadas . . . . . . . . . . . . . . 2Vistas incorporadas frente a funciones de tabla . . . 3Rutinas y vistas de SQL incorporadas soportadas . . 4

Rutinas administrativas y procedimientoADMIN_CMD . . . . . . . . . . . . 25Vistas y rutinas del planificador de tareasadministrativas . . . . . . . . . . . . 303Rutinas y procedimientos de auditoría . . . . 317Rutinas de mantenimiento automático . . . . 320Procedimientos de la API de SQL común . . . 326Rutinas y vistas de configuración. . . . . . 379Vistas y rutinas de información de la instanciade DB2 pureScale . . . . . . . . . . . 385Rutinas y vistas de entorno. . . . . . . . 395Rutinas de Explain . . . . . . . . . . 410Rutinas del supervisor . . . . . . . . . 429Rutinas de MQSeries . . . . . . . . . . 790Rutinas y vistas de seguridad . . . . . . . 812Rutinas y vistas de instantáneas . . . . . . 825Rutinas de procedimiento de SQL . . . . . 1105Rutinas de redistribución paso a paso . . . . 1115Rutinas de la herramienta de gestión dealmacenamiento . . . . . . . . . . . 1125Rutinas de búsqueda de texto . . . . . . 1129Rutinas de gestión de carga de trabajo. . . . 1168Rutinas y vistas varias . . . . . . . . . 1212

Vistas y rutinas administrativas de SQL en desuso 1260Función de tablaADMIN_GET_DBP_MEM_USAGE - Obtener elconsumo de memoria total por instancia . . . 1264Vista administrativaADMINTABCOMPRESSINFO y función detabla ADMIN_GET_TAB_COMPRESS_INFO(en desuso) - Devolver información decompresión. . . . . . . . . . . . . 1266ADMIN_GET_TAB_COMPRESS_INFO_V97 . . . . . . . . . . . . . . . 1271Función de tablaADMIN_GET_TAB_INFO_V95 - Recuperarinformación de tamaño y estado para las tablas 1277Función de tablaADMIN_GET_TAB_INFO_V97 - Recuperarinformación de tamaño y estado para las tablas 1284AM_BASE_RPT_RECOMS - Recomendacionespara informes de actividad . . . . . . . 1292AM_BASE_RPTS - Informes del supervisor desucesos de actividad. . . . . . . . . . 1294RAM_DROP_TASK - Supresión de una tareade supervisión . . . . . . . . . . . 1295RAM_GET_LOCK_CHN_TB - Recuperación dedatos de cadena de bloqueo de aplicación enformato tabular . . . . . . . . . . . 1296

RAM_GET_LOCK_CHNS - Recuperación deinformación de cadena de bloqueo para unaaplicación específica . . . . . . . . . . 1297RAM_GET_LOCK_RPT - Recuperación dedetalles de bloqueo de aplicación . . . . . 1298RAM_GET_RPT - Recuperación de datos delsupervisor de actividad . . . . . . . . 1306RAM_SAVE_TASK - Creación o modificaciónde una tarea de supervisión . . . . . . . 1307APPLICATION_ID . . . . . . . . . . 1308DB_PARTITIONS. . . . . . . . . . . 1309RGET_DB_CONFIG . . . . . . . . . . 1311GET_DBM_CONFIG . . . . . . . . . 1312Vista administrativa ENV_SYS_RESOURCES -Devolver información de sistema . . . . . 1314Vista administrativa LOCKS_HELD –Recuperar información acerca de los bloqueosretenidos . . . . . . . . . . . . . 1317Vista administrativa LOCKWAITS – Recuperarinformación de bloqueos actuales en espera deser activados . . . . . . . . . . . . 1320Rutinas de instantáneas de salud . . . . . 1324Vista administrativa REG_VARIABLES -Recuperar valores de registro de DB2 en uso . 1370Vista 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 . . . . 1372Función de tabla SNAP_GET_APPL_INFO_V95- Recuperar información de instantáneas delgrupo de datos lógicos appl_info . . . . . 1377Función de tabla SNAP_GET_APPL_V95 -Recuperar información de instantáneas delgrupo de datos lógicos appl . . . . . . . 1383Función de tabla SNAP_GET_BP_V95 -Recuperar información de instantáneas delgrupo lógico bufferpool . . . . . . . . 1391Función de tablaSNAP_GET_CONTAINER_V91 - Recuperarinformación acerca de la instantánea de grupode datos lógicos tablespace_container . . . . 1396Vista administrativaSNAPDB_MEMORY_POOL y función de tablaSNAP_GET_DB_MEMORY_POOL - Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . 1399Función de tabla SNAP_GET_DBM_V95 -Recuperar información de instantáneas delgrupo de datos lógicos dbm . . . . . . . 1404Vista administrativaSNAPDBM_MEMORY_POOL y función detabla SNAP_GET_DBM_MEMORY_POOL -Recuperar información sobre el uso de lamemoria en el nivel del gestor de bases dedatos . . . . . . . . . . . . . . . 1407

© Copyright IBM Corp. 2006, 2013 iii

Función de tabla SNAP_GET_DB_V97 -Recuperar información de instantánea desde elgrupo lógico dbase . . . . . . . . . . 1411Función de tablaSNAP_GET_DETAILLOG_V91 - Recuperarinformación de instantánea del grupo de datoslógico detail_log . . . . . . . . . . . 1422Función de tabla SNAP_GET_DYN_SQL_V95 -Recuperar información de la instantánea delgrupo de datos lógicos dynsql . . . . . . 1425Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR - Recuperarinformación de instantáneas del grupo dedatos lógicos hadr . . . . . . . . . . 1429Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK - Recuperarinformación de instantáneas del grupo dedatos lógicos lock . . . . . . . . . . 1434Vista administrativa SNAPLOCKWAIT yfunción de tabla SNAP_GET_LOCKWAIT -Recuperar información de instantáneas delgrupo de datos lógicos lockwait . . . . . . 1440SNAP_GET_STO_PATHS . . . . . . . . 1447Vista administrativa SNAPSTORAGE_PATHS yfunción de tablaSNAP_GET_STORAGE_PATHS_V97 -Recuperar información de vía de acceso dealmacenamiento automático . . . . . . . 1448Vista administrativa SNAPTAB y función detabla SNAP_GET_TAB – Recuperarinformación de instantáneas del grupo dedatos lógicos table . . . . . . . . . . 14511455Función de tabla SNAP_GET_TBSP_PART_V97- Recuperar información de instantáneas delgrupo de datos lógicos tablespace_nodeinfo . . 1458SNAP_GET_TBSP_V91 . . . . . . . . . 1462Vista 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 . . . . 1467Vista administrativaSNAPDB_MEMORY_POOL y función de tablaSNAP_GET_DB_MEMORY_POOL - Recuperarinformación sobre el uso de la memoria en elnivel de la base de datos . . . . . . . . 1472Vista administrativaSNAPDBM_MEMORY_POOL y función detabla SNAP_GET_DBM_MEMORY_POOL -Recuperar información sobre el uso de lamemoria en el nivel del gestor de bases dedatos . . . . . . . . . . . . . . . 1478Vista administrativa SNAPHADR y función detabla SNAP_GET_HADR - Recuperarinformación de instantáneas del grupo dedatos lógicos hadr . . . . . . . . . . 1481Vista administrativa SNAPLOCK y función detabla SNAP_GET_LOCK - Recuperarinformación de instantáneas del grupo dedatos lógicos lock . . . . . . . . . . 1486

Vista administrativa SNAPLOCKWAIT yfunción de tabla SNAP_GET_LOCKWAIT -Recuperar información de instantáneas delgrupo de datos lógicos lockwait . . . . . . 1492SNAPSHOT_AGENT . . . . . . . . . 1499SNAPSHOT_APPL . . . . . . . . . . 1500SNAPSHOT_APPL_INFO . . . . . . . . 1507SNAPSHOT_BP . . . . . . . . . . . 1509SNAPSHOT_CONTAINER . . . . . . . 1512SNAPSHOT_DATABASE . . . . . . . . 1514SNAPSHOT_DBM . . . . . . . . . . 1521SNAPSHOT_DYN_SQL . . . . . . . . 1523SNAPSHOT_FCM . . . . . . . . . . 1525SNAPSHOT_FCMNODE . . . . . . . . 1527SNAPSHOT_FILEW . . . . . . . . . . 1528SNAPSHOT_LOCK . . . . . . . . . . 1529SNAPSHOT_LOCKWAIT . . . . . . . . 1531SNAPSHOT_QUIESCERS . . . . . . . . 1533SNAPSHOT_RANGES . . . . . . . . . 1534SNAPSHOT_STATEMENT . . . . . . . 1535SNAPSHOT_SUBSECT . . . . . . . . . 1538SNAPSHOT_SWITCHES . . . . . . . . 1540SNAPSHOT_TABLE. . . . . . . . . . 1542SNAPSHOT_TBREORG . . . . . . . . 1543SNAPSHOT_TBS . . . . . . . . . . . 1545SNAPSHOT_TBS_CFG . . . . . . . . . 1548Vista administrativa SNAPSTORAGE_PATHS yfunción de tablaSNAP_GET_STORAGE_PATHS_V97 -Recuperar información de vía de acceso dealmacenamiento automático . . . . . . . 1551Vista administrativa SNAPTAB y función detabla SNAP_GET_TAB – Recuperarinformación de instantáneas del grupo dedatos lógicos table . . . . . . . . . . 1554SQLCACHE_SNAPSHOT . . . . . . . . 1558RSYSINSTALLROUTINES . . . . . . . . 1560WLM_GET_ACTIVITY_DETAILS - Devolverinformación detallada sobre una actividadespecífica . . . . . . . . . . . . . 1560WLM_GET_SERVICE_CLASS_AGENTS_V97 - Listar los agentes que se ejecutan enuna clase de servicio . . . . . . . . . 1567WLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES_V97 - List ofworkload occurrences . . . . . . . . . 1574WLM_GET_SERVICE_SUBCLASS_STATS_V97 - Devolver estadísticas desubclases de servicio . . . . . . . . . 1577WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES_V97 - Devolver una lista de actividades . . . 1584WLM_GET_WORKLOAD_STATS_V97 -Devolver estadísticas de carga de trabajo . . . 1589

Apéndice A. Visión general de lainformación técnica de DB2 . . . . 1593Biblioteca técnica de DB2 en copia impresa o enformato PDF . . . . . . . . . . . . . 1594Visualización de la ayuda para estados de SQLdesde el procesador de línea de mandatos . . . 1596

iv Rutinas y vistas administrativas

Acceso a diferentes versiones del Centro deinformación de DB2 . . . . . . . . . . . 1596Actualización del Centro de información de DB2instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1597Actualización manual del Centro de informaciónde DB2 instalado en el sistema o en el servidor deintranet . . . . . . . . . . . . . . . 1598

Guías de aprendizaje de DB2 . . . . . . . . 1600Información de resolución de problemas de DB2 1601Términos y condiciones . . . . . . . . . 1601

Apéndice B. Avisos . . . . . . . . 1603

Índice . . . . . . . . . . . . . . 1607

Contenido v

vi Rutinas y vistas administrativas

Vistas y rutinas incorporadas

Las vistas y rutinas administrativas incorporadas proporcionan una interfazprogramática simplificada para administrar y utilizar bases de datos DB2 y objetosde base de datos mediante SQL (lenguaje de consulta estructurada). Las rutinasincorporadas engloban procedimientos, funciones escalares y funciones de tabla.

Puede utilizar rutinas y vistas incorporadas para realizar diversas tareas de DB2.Por ejemplo, puede utilizar rutinas incorporadas para reorganizar una tabla,capturar y recuperar datos del supervisor o recuperar el ID de aplicación de laconexión actual.

Puede invocar estas vistas rutinas incorporadas desde una aplicación basada enSQL, una línea de mandatos de DB2 o un script de mandatos.

Recomendaciones para llamar a rutinas y vistas incorporadas enaplicaciones

Para garantizar el uso satisfactorio de las rutinas y las vistas incorporadas, sehacen ciertas recomendaciones sobre codificación. Tales recomendaciones sonespecialmente importantes porque las rutinas pueden cambiar de un release a otroy también dentro de un mismo release, como, por ejemplo, mediante fixpacks,cuando se efectúan mejoras.

Cuando emita una consulta para recuperar información mediante una rutina o unavista incorporada, seleccione columnas específicas, en lugar de seleccionar todas lascolumnas con un comodín. Por ejemplo, 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. Con esta técnica se proporciona a la aplicación control sobre el número decolumnas de resultado y la secuencia en la que se devuelven. En la versiónmodificada de la consulta anterior que se muestra a continuación, las columnas sellaman así: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

Mencionar las columnas evita problemas cuando la secuencia y el número decolumnas de las rutinas cambian. El número de columnas de resultado que unarutina devuelve puede aumentar. Si, por ejemplo, proporciona sólo cinco variablesdel lenguaje principal, pero la rutina devuelve 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 en

© Copyright IBM Corp. 2006, 2013 1

una 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 C frente a esos cambios, puede describir unasentencia preparada a fin de determinar las columnas de resultado que se van adevolver y los tipos y tamaños que tienen. El ejemplo siguiente muestra cómodescribir una sentencia preparada: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;

Para ver un ejemplo acerca de cómo utilizar la información que se devuelve en elárea de descripción de SQL (SQLDA), consulte la función RowDatamemoryAllocen el archivo samples/c/tbread.sqc.

En el caso de las aplicaciones Java y .NET, es necesario saber el tipo y el tamañode los datos para un programa; puede utilizar metadatos para determinar lascolumnas de resultado que se van a devolver y sus tipos y tamaños, como seindica a continuación.ResultSet rs = pstmt.executeQuery();ResultSetMetaData rsms = rs.getMetaData();

Para ver un ejemplo acerca de cómo utilizar los metadatos del conjunto deresultados, consulte el método execPreparedQueryWithUnknownOutputColumn( )en el archivo samples/java/jdbc/TbRead.java.

Autorizaciones para utilizar vistas y rutinas incorporadasTodas las vistas y rutinas incorporadas necesitan privilegios específicos para poderejecutarlas.

Rutinas incorporadas

Para todas las rutinas incorporadas del esquema SYSPROC, necesita el privilegioEXECUTE para la rutina. Puede utilizar la consulta siguiente para comprobar si su IDde autorización, o un grupo o un rol al que pertenece, dispone de privilegioEXECUTE:SELECT A.SPECIFICNAME, GRANTEE, GRANTEETYPE

FROM SYSCAT.ROUTINEAUTH A, SYSCAT.ROUTINES RWHERE A.SCHEMA = R.ROUTINESCHEMA

AND A.SPECIFICNAME = R.SPECIFICNAMEAND A.SCHEMA = ’SYSPROC’AND R.ROUTINENAME = ’nombre_rutina’AND A.EXECUTEAUTH ’N’

donde nombre_rutina es el nombre de la rutina incorporada.

Si su ID de autorización, o un grupo o un rol al que pertenece, aparece en lacolumna GRANTEE, dispone de acceso a la rutina incorporada especificada.

2 Rutinas y vistas administrativas

Vistas incorporadas

Para todas las vistas incorporadas del esquema SYSIBMADM, necesita el privilegioSELECT para la vista. Puede utilizar la consulta siguiente para comprobar si su IDde autorización, o un grupo o un rol al que pertenece, dispone de privilegioSELECT:SELECT GRANTEE, GRANTEETYPE

FROM SYSCAT.TABAUTHWHERE TABSCHEMA = ’SYSIBMADM’

AND TABNAME = ’nombre_vista’AND SELECTAUTH ’N’

donde nombre_vista es el nombre de la vista incorporada.

Si su ID de autorización, o un grupo o un rol al que pertenece, aparece en lacolumna GRANTEE, dispone de acceso a la vista incorporada especificada.

Vistas incorporadas frente a funciones de tablaLas vistas incorporadas proporcionan una interfaz de programación de aplicacionessimplificada para las funciones de DB2 por medio de SQL.

Las vistas incorporadas se dividen en tres categorías:v Vistas basadas en vistas de catálogosv Vistas basadas en funciones de tablas sin parámetros de entradav Vistas basadas en funciones de tablas con uno o más parámetros de entrada

Una función de tabla puede devolver información similar a la de la vistaincorporada, sin embargo, puede utilizar una función de tabla para recuperar lainformación para una base de datos específica en una partición de base de datosespecífica, un subconjunto de todas las particiones de base de datos o todas lasparticiones de base de datos.

En los ejemplos siguientes se muestra la diferencia entre el uso de una vistaincorporada, basada en una función de tabla con uno o varios parámetros deentrada, y el uso de la función de tabla correspondiente:v La vista PDLOGMSGS_LAST24HOURS, que recupera mensajes del registro de

notificaciones, ofrece un acceso rápido a los datos de las últimas 24 horas. Pararecuperar datos de un período de tiempo concreto, puede utilizar la función detabla PD_GET_LOG_MSGS.

v Las vistas del supervisor de instantáneas, que se identifican mediante nombresque empiezan por SNAP, proporcionan acceso a los datos desde cada partición debase de datos. Sin embargo, las funciones de tabla del supervisor deinstantáneas, que se identifican mediante nombres que empiezan por SNAP_GET_,ofrecen la opción de elegir entre los datos de una única partición de base dedatos o un subconjunto de datos de todas las particiones de base de datos.

v La vista ADMINTABINFO recupera información para todas las tablas de una base dedatos; esto puede afectar de forma significativa al rendimiento de lasaplicaciones que utilizan bases de datos de gran tamaño. En lugar de ello, puedereducir el impacto en el rendimiento mediante el uso de la función de tablaADMIN_GET_TAB_INFO y la especificación de un nombre de esquema, un nombrede tabla o ambos como entrada.

Vistas y rutinas incorporadas 3

Para las vistas incorporadas basadas en funciones de tabla con uno o másparámetros de entrada pueden utilizarse la vista incorporada y la función de tabla,cada una de las cuales satisface un objetivo distinto:

Las vistas incorporadas siempre están basadas en la versión más actual de lasfunciones de tabla. Sin embargo, las posiciones de las columnas en la informacióndevuelta pueden cambiar de un release a otro para permitir que se devuelva nuevainformación. Por lo tanto, debe seleccionar columnas específicas de las vistasincorporadas o las funciones de tabla, o describir el conjunto de resultados si laaplicación utiliza una sentencia SELECT *.

Las funciones de tabla con un sufijo de versión (_Vxx) han quedado en desuso o sehan dejado de mantener. Las funciones en desuso podrían dejarse de mantener enun futuro release. Por lo tanto, deberá cambiar las aplicaciones y los scripts queutilicen estas funciones de tabla, de manera que invoquen las funciones de tablacorrespondientes que no tienen un sufijo de versión.

Rutinas y vistas de SQL incorporadas soportadasProporciona información acerca de las vistas y rutinas de SQL incorporadassoportadas.

En este tema se proporciona información acerca de las rutinas de SQL incorporadassiguientes:v Rutinas de SQL incorporadas y procedimiento almacenado ADMIN_CMD:

Tabla 1 en la página 5v Vistas y rutinas del planificador de tareas administrativas: Tabla 2 en la página 6v Rutinas y procedimientos de auditoría: Tabla 3 en la página 7v Vistas y rutinas de SQL incorporadas de mantenimiento automático: Tabla 4 en

la página 7v Procedimientos almacenados de la API de SQL común: Tabla 5 en la página 7v Vistas y rutinas de SQL incorporadas de configuración: Tabla 6 en la página 8v Vistas administrativas de la instancia de DB2 pureScale: Tabla 7 en la página 8v Vistas y rutinas de SQL incorporadas de entorno: Tabla 8 en la página 9v Rutinas de Explain: Tabla 9 en la página 9v Rutinas de SQL incorporadas de supervisor: Tabla 10 en la página 10v Rutinas de SQL incorporadas de MQSeries: Tabla 11 en la página 16v Vistas y rutinas de SQL incorporadas de seguridad: Tabla 12 en la página 17v Vistas y rutinas de SQL incorporadas de instantánea: Tabla 13 en la página 17v Rutinas incorporadas de procedimiento de SQL: Tabla 14 en la página 21v Rutinas de SQL incorporadas de redistribución gradual: Tabla 15 en la página 21v Rutinas de SQL incorporadas de la herramienta de gestión de almacenamiento:

Tabla 16 en la página 22v Rutinas de SQL incorporadas de búsqueda de texto: Tabla 17 en la página 22v Rutinas de gestión de carga de trabajo: Tabla 18 en la página 23v Vistas y rutinas de SQL incorporadas varias: Tabla 19 en la página 24


Tabla 1. Rutinas de SQL administrativas

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.

Procedimiento ADMIN_COPY_SCHEMASYSPROC Este procedimiento sirve para copiar un

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

Procedimiento ADMIN_DROP_SCHEMASYSPROC Este procedimiento sirve para descartar un

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

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.

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 escalarADMIN_GET_INTRA_PARALLEL

SYSPROC Esta función escalar devuelve el estadoactual del paralelismo intrapartición para laaplicación.

Función de tabla ADMIN_GET_MEM_USAGESYSPROC Esta función de tabla devuelve las

estadísticas de uso de memoria para unmiembro concreto.

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 de tablaADMIN_GET_STORAGE_PATHS

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.

Función de tablaADMIN_GET_TAB_COMPRESS_INFO

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

Función de tablaADMIN_GET_TAB_DICTIONARY_INFO

SYSPROC Esta función de tabla devuelve informaciónde diccionario para tablas, tablas deconsulta materializada (MQT) y tablas dejerarquía.


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


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_MOVE_TABLE

SYSPROC Este procedimiento mueve datos de unatabla activa a un objeto de tabla nuevo quetiene el mismo nombre, y durante elproceso los datos continúan en línea y sepuede acceder a ellos.

Procedimiento ADMIN_MOVE_TABLE_UTILSYSPROC Este procedimiento modifica los valores

definibles por el usuario empleados por elprocedimiento ADMIN_MOVE_TABLE.

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.

ProcedimientoADMIN_SET_INTRA_PARALLEL

SYSPROC Este procedimiento habilita o inhabilita elparalelismo intrapartición para unaaplicación de base de datos.

Procedimiento ADMIN_SET_MAINT_MODE

SYSPROC Este procedimiento establece un distintivointerno para la conexión actual de modoque, cuando se ejecute el SQL, no seexpanda ningún activador ni restriccióndurante la compilación de SQL.

ADMINTABINFO y ADMIN_GET_TAB_INFO

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


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


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


Tabla 2. Vistas y rutinas del planificador de tareas administrativas (continuación)


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 3. Rutinas y procedimientos de auditoría


Procedimiento y función de tablaAUDIT_ARCHIVE

SYSPROC Este procedimiento y la función de tablaarchivan las anotaciones cronológicas deauditoría.

Procedimiento AUDIT_DELIM_EXTRACT SYSPROC Este procedimiento extrae datos de lasanotaciones cronológicas archivadas deforma binaria y los carga en archivosdelimitados.

Función de tabla AUDIT_LIST_LOGS SYSPROC Esta función de tabla devuelve una lista delas anotaciones cronológicas de auditoríaarchivadas en la vía de acceso especificadapara la base de datos actual.

Tabla 4. Vistas y rutinas de SQL incorporadas de mantenimiento automático


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.

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 5. 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 DESIGN_ADVISORSYSPROC Este procedimiento recupera las

recomendaciones del asesor de diseñodesde un servidor de IBM® DB2 10.1.


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


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 6. Vistas y rutinas de SQL incorporadas de configuración


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.

Tabla 7. Vistas administrativas de la instancia de DB2 pureScale

Nombre de vista Esquema Descripción

Función de tabla DB_MEMBERSSYSIBMADM Esta función de tabla devuelve información

básica de los miembros sobre una instanciade DB2 pureScale.

Vista administrativaDB2_CLUSTER_HOST_STATE

SYSIBMADM La vista administrativaDB2_CLUSTER_HOST_STATE y la funciónde tablaDB2_GET_CLUSTER_HOST_STATEasociada recuperan información acerca delos sistemas principales que forman partede una instancia de DB2 pureScale.

Vista administrativa DB2_INSTANCE_ALERTSSYSIBMADM Esta vista proporciona información acerca

de las alertas de la instancia de DB2pureScale.


Tabla 7. Vistas administrativas de la instancia de DB2 pureScale (continuación)


Vistas administrativas DB2_MEMBER yDB2_CF

SYSIBMADM Las vistas administrativas DB2_MEMBER yDB2_CF y la función de tablaDB2_GET_INSTANCE_INFO asociadadevuelven información acerca de losmiembros y los recursos de almacenamientoen antememoria de clúster de una instanciade DB2 pureScale, incluida la informaciónde estado, si procede.

Tabla 8. Vistas y rutinas de SQL incorporadas de entorno


Vista administrativaENV_CF_SYS_RESOURCES

SYSIBMADM Esta vista devuelve una lista de los recursosdel sistema que utilizan los recursos dealmacenamiento en antememoria de clúster(conocidos también como CF) en el sistema.

Vista administrativa ENV_FEATURE_INFO

SYSPROC Esta vista administrativa devuelveinformación sobre todas las característicasdisponibles para las que se necesita unalicencia.

Función de tablaENV_GET_DB2_SYSTEM_RESOURCES

SYSPROC Esta función de tabla devuelve la utilizaciónde la CPU y la información de proceso deDB2 correspondiente a los miembrosespecificados en la instancia actual.

Función de tablaENV_GET_NETWORK_RESOURCES

SYSPROC Esta función de tabla devuelve informacióncorrespondiente a todos los adaptadores dered activos en las máquinas de sistemaprincipal en las que se ejecuta DB2.

Función de tabla ENV_GET_REG_VARIABLESSYSPROC Esta función de tabla devuelve los valores

de registro de DB2 de uno o de todos losmiembros de base de datos.

Función de tablaENV_GET_SYSTEM_RESOURCES

SYSPROC Esta función de tabla devuelve informacióndel sistema operativo, CPU, memoria y otrainformación relacionada con los miembrosdel sistema.

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.

Tabla 9. Rutinas de Explain


Función de tablaEXPLAIN_GET_MSGS

El esquema es el mismo que el de latabla de Explain.

Esta función de tabla consulta lastablas de Explain deEXPLAIN_DIAGNOSTIC yEXPLAIN_DIAGNOSTIC_DATA ydevuelve mensajes con formato.


Tabla 9. Rutinas de Explain (continuación)


Función escalarEXPLAIN_FORMAT_STATS

SYSPROC La nueva función escalar se usa paramostrar información estadísticaformateada analizada y extraída deuna instantánea de explicacióncapturada para una consultadeterminada.

ProcedimientoEXPLAIN_FROM_ACTIVITY

SYSPROC Este procedimiento explica unaejecución específica de una sentenciamediante la utilización del contenidode la sección que se ha obtenido deun supervisor de sucesos deactividad.

ProcedimientoEXPLAIN_FROM_CATALOG

SYSPROC Este procedimiento explica unasentencia mediante la utilización delcontenido de la sección que se haobtenido de los catálogos.

ProcedimientoEXPLAIN_FROM_DATA

SYSPROC Este procedimiento explica unasentencia mediante el contenido de lasección de entrada.

ProcedimientoEXPLAIN_FROM_SECTION

SYSPROC Este procedimiento explica unasentencia mediante la utilización delcontenido de la sección que se haobtenido de la antememoria depaquete o del supervisor de sucesosde antememoria de paquete.

Tabla 10. Rutinas de SQL del supervisor


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.

Procedimiento EVMON_UPGRADE_TABLES

SYSPROC Este procedimiento modifica tablas desucesos sin formato o SQL de destinodel supervisor de sucesos paraacomodar elementos de supervisiónnuevos o modificados que se hayanañadido desde que se creó elsupervisor de sucesos.

Vista administrativa MON_BP_UTILIZATION

SYSIBMADM Esta vista administrativa devuelvemétricas de supervisión clave,incluidas las tasas de aciertos y eltiempo medio de lectura y grabación,para todas las agrupaciones dealmacenamientos intermedios y todaslas particiones de base de datos de labase de datos actualmente conectada.


Tabla 10. Rutinas de SQL del supervisor (continuación)


Vista administrativa MON_CONNECTION_SUMMARY

SYSIBMADM Esta vista administrativa devuelvemétricas clave para todas lasconexiones de la base de datosactualmente conectada.

Vista administrativa MON_CURRENT_SQL

SYSIBMADM Esta vista administrativa métricas clavepara todas las actividades que se hanenviado a todos los miembros de labase de datos y que todavía no se hancompletado.

Vista administrativa MON_CURRENT_UOW

SYSIBMADM Esta vista administrativa devuelvemétricas clave para todas las unidadesde trabajo que se han enviado en todoslos miembros de la base de datos.

Vista administrativa MON_DB_SUMMARY

SYSIBMADM Esta vista administrativa devuelve lasmétricas clave acumuladas de todas lasclases de servicios de la base de datosactualmente conectada.

Función de tabla MON_FORMAT_LOCK_NAME

SYSPROC Esta función de tabla formatea elnombre de bloqueo interno y devuelvedetalles relacionados con el bloqueo enun formato basado en filas.

Función de tablaMON_FORMAT_XML_COMPONENT_TIMES_BY_ROW

SYSPROC Esta función de tabla devuelve unasalida formateada basada en filas delos tiempos de componente contenidosen un documento XML de métricas.

Función de tablaMON_FORMAT_XML_METRICS_BY_ROW

SYSPROC Esta función de tabla devuelve unasalida basada en filas formateada paratodas las métricas contenidas en undocumento de métricas XML.

Función de tablaMON_FORMAT_XML_TIMES_BY_ROW

SYSPROC Esta función de tabla devuelve lasalida basada en filas formateada parala jerarquía combinada de tiempos deespera y proceso contenidos en undocumento de métrica XML.

Función de tablaMON_FORMAT_XML_WAIT_TIMES_BY_ROW

SYSPROC Esta función de tabla devuelve salidaformateada basada en filas para lostiempos de espera que estáncontenidos en un documento XML demétricas.

MON_GET_ACTIVITY_DETAILS

SYSPROC Esta función de tabla devuelve detallessobre una actividad, incluidainformación de actividad general y unconjunto de métricas para la actividad.

Función de tabla MON_GET_APPL_LOCKWAIT

SYSPROC Esta función de tabla devuelveinformación acerca de todos losbloqueos que cada uno de los agentesde la aplicación (conectados con labase de datos actual) está a la esperade adquirir.

Función escalar MON_GET_APPLICATION_HANDLESYSPROC Esta función escalar devuelve el

descriptor de contexto de la aplicaciónque la invoca.




Función escalar MON_GET_APPLICATION_IDSYSPROC Esta función escalar devuelve el ID de

la aplicación que la invoca.

Función de tabla MON_GET_AUTO_MAINT_QUEUE

SYSPROC Esta función de tabla devuelveinformación acerca de todos lostrabajos de mantenimiento automático(con la excepción de las estadísticas entiempo real que no envían trabajos a lacola de mantenimiento automático) queactualmente están en cola para que losejecute el daemon de informáticaautónoma (db2acd).

Función de tablaMON_GET_AUTO_RUNSTATS_QUEUE

SYSPROC Esta función de tabla devuelveinformación sobre todos los objetos queestán actualmente en cola para que losevalúe la recolección automática deestadísticas en la base de datosconectada actualmente.

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_CF

SYSPROC Esta función de tabla devuelveinformación de estado acerca de uno ovarios recursos de almacenamiento enantememoria de clúster en un entornoDB2 pureScale.

Función de tabla MON_GET_CF_CMD

SYSPROC Esta función de tabla devuelveinformación acerca del tiempo deproceso de los mandatos del recurso dealmacenamiento en antememoria declúster (CF).

Función de tabla MON_GET_CF_WAIT_TIME

SYSPROC Esta función de tabla informa sobre lacantidad de tiempo total, enmicrosegundos, que se ha pasadoesperando a que los recursos dealmacenamiento en antememoria declúster (CF) procesen una petición. Estetiempo incluye el tiempo invertido enlas comunicaciones relacionadas conlos recursos de almacenamiento enantememoria de clúster.

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 tabla MON_GET_EXTENDED_LATCH_WAIT

SYSPROC Esta función devuelve informaciónacerca de los mecanismos de cierre queestán implicados en esperas largas delmecanismo de cierre.

Función de tablaMON_GET_EXTENT_MOVEMENT_STATUS

SYSPROC Esta función de tabla devuelve elestado de la operación de traslado deextensiones.

Función de tabla MON_GET_FCMSYSPROC Esta función de tabla devuelve

métricas para el gestor decomunicaciones rápidas (FCM).

Función de tabla 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.

Función de tabla MON_GET_GROUP_BUFFERPOOL

SYSPROC Esta función de tabla devuelveestadísticas sobre la agrupación dealmacenamientos intermedios degrupo, incluido el número de vecesque se ha dado el error GBP_FULL.

Función de tabla MON_GET_HADR

SYSPROC Esta función devuelve la informaciónde supervisión de la recuperación decatástrofes de alta disponibilidad(HADR).

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_INDEX_USAGE_LISTSYSPROC Esta función de tabla devuelve

información de una lista de usodefinida para un índice.

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_POOLSYSPROC Esta función de tabla recupera métricas

de las agrupaciones de memoriacontenidas en un conjunto de memoria.

Función de tabla MON_GET_MEMORY_SETSYSPROC Esta función de tabla recupera métricas

de las agrupaciones de memoriacontenidas en un conjunto de memoria.

Función de tabla MON_GET_PAGE_ACCESS_INFO

SYSPROC Esta función de tabla devuelveinformación acerca de las páginas de laagrupación de almacenamientointermedios que han estado esperandouna tabla especificada.

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 tablaMON_GET_PKG_CACHE_STMT_DETAILS

SYSPROC Esta función de tabla devuelvemétricas detalladas para una o másentradas de antememoria de paquete.




Función de tabla MON_GET_REBALANCE_STATUSSYSPROC Esta función de tabla devuelve el

estado de una operación dereequilibrado en un espacio de tablas.

Función de tabla MON_GET_ROUTINE

SYSPROC Esta función de tabla devuelvemétricas de ejecución agregadas paralos procedimientos, procedimientosexternos, funciones compiladas,activadores compilados y bloquesanónimos invocados desde que seactivara la base de datos.

Función de tabla MON_GET_ROUTINE_DETAILS

SYSPROC Esta función de tabla devuelvemétricas de ejecución agregadas paralos procedimientos, funciones externas,funciones compiladas, activadorescompilados y bloques anónimosinvocados desde que se activara labase de datos. Las métricas sedevuelven en un documento XML.

Función de tabla MON_GET_ROUTINE_EXEC_LIST

SYSPROC Esta función de tabla devuelve unalista de todas las sentencias (secciones)que ha ejecutado cada procedimiento,función externa, función compilada,activador compilado y bloque anónimoinvocados desde que se activara labase de datos.

Función de tabla MON_GET_RTS_RQST

SYSPROC Esta función de tabla devuelveinformación acerca de todas laspeticiones de estadísticas en tiemporeal que están pendientes en el sistema,y acerca del conjunto de peticiones queactualmente está procesando eldaemon de estadísticas en tiempo real(como la cola de proceso deestadísticas en tiempo real).

Función de tabla MON_GET_SECTION_ROUTINE

SYSPROC Esta función de tabla devuelve unalista de todos los procedimientos,funciones externas, funcionescompiladas y activadores compiladosque podrían invocarse durante laejecución de la sección de entrada.

Función de tabla MON_GET_SERVERLIST

SYSPROC Esta función de tabla devuelve lasmétricas de la lista de servidores parala base de datos conectadaactualmente, almacenada en laantememoria para uno o variosmiembros.

Función de tabla MON_GET_SERVICE_SUBCLASSSYSPROC Esta función de tabla devuelve

métricas para una o varias subclases deservicio.

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_TABLE_USAGE_LISTSYSPROC Esta función de tabla devuelve

información de una lista de usodefinida para una tabla.

Función de tabla MON_GET_TRANSACTION_LOG

SYSPROC Esta función de tabla devuelveinformación acerca del subsistema deanotaciones cronológicas detransacciones para la base de datosconectada actualmente.

Función de tabla MON_GET_UNIT_OF_WORKSYSPROC Esta función de tabla devuelve

métricas para una o varias unidades detrabajo.

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_USAGE_LIST_STATUSSYSPROC Esta función de tabla devuelve el

estado de una lista de uso.

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.

Procedimiento MON_INCREMENT_INTERVAL_ID

SYSPROC Este procedimiento incrementa elintervalo de supervisión en 1 ydevuelve el nuevo valor en elargumento de salida.

Vista administrativa MON_LOCKWAITS

SYSPROC Esta vista administrativa devuelveinformación sobre los agentes quetrabajan en nombre de las aplicacionesque están a la espera de obtenerbloqueos en la base de datos conectadaactualmente.

Vista administrativa MON_PKG_CACHE_SUMMARY

SYSIBMADM Esta vista administrativa devuelvemétricas clave para las sentencias deSQL estático y dinámico, ambas, de laantememoria, lo que proporciona unresumen de alto nivel de laantememoria de paquete de la base dedatos.

Función de tablaMON_SAMPLE_SERVICE_CLASS_METRICS

SYSPROC Esta función de tabla lee métricas delsistema de una o varias clases deservicio en una o varias bases de datosen dos puntos en el tiempo: cuando sellama a la función y después de quehaya transcurrido un período detiempo determinado.




Función de tablaMON_SAMPLE_WORKLOAD_METRICS

SYSPROC Esta función de tabla lee métricas delsistema de una o varias cargas detrabajo en una o varias bases de datosen dos puntos en el tiempo: cuando sellama a la función y después de quehaya transcurrido un período detiempo determinado.

Vista administrativaMON_SERVICE_SUBCLASS_SUMMARY

SYSIBMADM La vista administrativa devuelvemétricas clave para todas las subclasesde servicios de la base de datosactualmente conectada.

Vista administrativa MON_TBSP_UTILIZATION

SYSIBMADM Esta vista administrativa devuelvemétricas de supervisión clave,incluidas las tasas de aciertos y elporcentaje de utilización, de todos losespacios de tablas y todas lasparticiones de base de datos de la basede datos actualmente conectada.

Vista administrativa MON_WORKLOAD_SUMMARY

SYSIBMADM Esta vista administrativa devuelvemétricas clave para todas las cargas detrabajo de la base de datos actualmenteconectada.

Tabla 11. Rutinas de SQL incorporadas de MQSeries


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.

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.


Tabla 11. Rutinas de SQL incorporadas de MQSeries (continuación)


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 de SQL incorporadas de seguridad


Función escalarAUTH_GET_INSTANCE_AUTHID

SYSPROC Esta función escalar devuelve el ID deautorización del propietario de instancia.

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.

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 de SQL incorporadas de instantánea


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.


Tabla 13. Vistas y rutinas de SQL incorporadas de instantánea (continuación)


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 bloqueosretenidos actuales.

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.

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


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 administrativa SNAPAPPL y función detabla SNAP_GET_APPL


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


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


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


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 tabla SNAP_GET_CONTAINER


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


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


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.

Vista administrativa SNAPDETAILLOG yfunción de tabla SNAP_GET_DETAILLOG


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


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


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


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 SNAPLOCK y función detabla 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.




Vista administrativa SNAPLOCKWAIT yfunción de tabla 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.

Vista administrativa SNAPSTMT y función detabla SNAP_GET_STMT


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

Vista administrativa SNAPSUBSECTION yfunción de tabla SNAP_GET_SUBSECTION


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

Vista administrativa SNAPSWITCHES yfunción de tabla SNAP_GET_SWITCHES


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


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


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


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


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


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


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


Esta vista administrativa y función de tabladevuelven información de instantáneaacerca de los programas de utilidad delgrupo de datos lógicos utility_info.

Vista administrativa SNAPUTIL_PROGRESS yfunción de tabla SNAP_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.

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.

Tabla 14. Rutinas incorporadas de procedimiento de SQL


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.

Procedimiento GET_ROUTINE_NAMESYSPROC Este procedimiento devuelve el nombre de

un objeto SQL PL según el valor LIB_ID delobjeto.

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 rutina deSQL 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 de SQL incorporadas de redistribución gradual


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 de SQL incorporadas de la herramienta de gestión de almacenamiento


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 descarta las tablas degestión de almacenamiento.

Tabla 17. Rutinas de SQL incorporadas de búsqueda de texto


Procedimiento almacenadoSYSTS_ADMIN_CMD

SYSPROC Este procedimiento ejecuta mandatosadministrativos de búsqueda de textoutilizando la sentencia de SQL CALL.

Procedimiento SYSTS_ALTERSYSPROC Este procedimiento cambia las

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

Procedimiento SYSTS_CLEANUPSYSPROC Este procedimiento habilita la supresión de

las colecciones de índices de DB2 TextSearch contenidas en una base de datos.

ProcedimientoSYSTS_CLEAR_COMMANDLOCKS

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.

Procedimiento SYSTS_CLEAR_EVENTSSYSPROC Este procedimiento suprime los sucesos de

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

Procedimiento SYSTS_CONFIGURESYSPROC Este procedimiento aplica la información de

conexión del servidor de búsqueda de textoal catálogo de búsqueda de texto

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

Procedimiento SYSTS_DISABLESYSPROC Este procedimiento inhabilita la búsqueda

de texto de DB2 para la base de datosactual.

Procedimiento SYSTS_DROPSYSPROC Este procedimiento descarta un índice de

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

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

Procedimiento 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 17. Rutinas de SQL incorporadas de búsqueda de texto (continuación)


Procedimiento SYSTS_UPGRADE_CATALOG

SYSPROC Este procedimiento actualiza el catálogo deDB2 Text Search, incluidas las tablasadministrativas y las vistas administrativas,a la versión del producto más reciente.

Procedimiento SYSTS_UPGRADE_INDEXSYSPROC Este procedimiento actualiza la información

de los índices de DB2 Text Search en lastablas de catálogos de búsqueda de texto.

Tabla 18. Rutinas de SQL incorporadas de gestión de carga de trabajo


Procedimiento WLM_CANCEL_ACTIVITY SYSPROC Este procedimiento cancela la actividaddada.

ProcedimientoWLM_CAPTURE_ACTIVITY_IN_PROGRESS

SYSPROC Este procedimiento envía informaciónacerca de una actividad determinada alsupervisor de sucesos de actividades.

Procedimiento WLM_COLLECT_STATS SYSPROC Este procedimiento envía estadísticas paraclases de servicio, cargas de trabajo, clasesde trabajo y colas de umbral al supervisorde sucesos estadísticos y restaura la copiaen memoria de las estadísticas.

Función de tabla WLM_GET_CONN_ENV SYSPROC Esta función de tabla devuelve los valoresde configuración que controlan larecopilación de datos de actividad y devalores reales de sección para unadeterminada conexión.

Función de tabla WLM_GET_QUEUE_STATS SYSPROC Esta función de tabla devuelve informaciónestadística básica de una o más colas deumbral.

Función de tablaWLM_GET_SERVICE_CLASS_AGENTS

SYSPROC Esta función de tabla devuelve la lista deagentes en la partición dada que ejecutanen la clase de servicioSERVICE_SUPERCLASS_NAME ySERVICE_SUBCLASS_NAME o en nombrede la aplicación dada porAPPLICATION_HANDLE.

Función de tablaWLM_GET_SERVICE_CLASS_WORKLOAD_OCCURRENCES

SYSPROC Esta función de tabla devuelve la lista detodas las ocurrencias de carga de trabajoque se ejecutan en una determinada clasede servicio de una determinada partición.

Función de tablaWLM_GET_SERVICE_SUBCLASS_STATS

SYSPROC Esta función de tabla devuelve lasestadísticas básicas de una o más subclasesde servicio.

Función de tablaWLM_GET_SERVICE_SUPERCLASS_STATS

SYSPROC Esta función de tabla devuelve lasestadísticas básicas de una o mássuperclases de servicio.

Función de tablaWLM_GET_WORK_ACTION_SET_STATS

SYSPROC Esta función de tabla devuelve lasestadísticas básicas de clases de trabajo enun conjunto de acciones de trabajo.


Tabla 18. Rutinas de SQL incorporadas de gestión de carga de trabajo (continuación)


Función de tablaWLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES

SYSPROC Esta función de tabla devuelve la lista detodas las actividades enviadas a través dela aplicación especificada de la particiónespecificada y que aún no se hancompletado.

Función de tablaWLM_GET_WORKLOAD_STATS

SYSPROC Esta función de tabla devuelve lasestadísticas básicas de una o más cargas detrabajo.

Procedimiento WLM_SET_CLIENT_INFO SYSPROC Este procedimiento establece la informaciónasociada con la conexión actual en elservidor de bases de datos DB2.

Procedimiento WLM_SET_CONN_ENV SYSPROC Este procedimiento habilita la recopilaciónde datos de actividad y la medición devalores reales de sección (estadísticas detiempo de ejecución durante la ejecución desección) en una determinada conexión.

Tabla 19. Vistas y rutinas de SQL incorporadas varias


Procedimiento ALTOBJ

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

Función de tabla COMPILATION_ENVSYSPROC Esta función de tabla devuelve los

elementos de un entorno de compilación.

Vista administrativa CONTACTGROUPSSYSIBMADM Esta vista administrativa devuelve

información acerca de la lista de contactos.

Vista administrativa CONTACTSSYSIBMADM La vista administrativa devuelve la lista de

contactos definidos en el servidor de basesde datos.

Vista administrativa DB_HISTORYSYSIBMADM Esta administrativa devuelve información

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

Vista administrativa DBPATHS

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

Procedimiento GET_DBSIZE_INFOSYSPROC Este procedimiento calcula el tamaño de

base de datos y la capacidad máxima.

Vista administrativa NOTIFICATIONLIST

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

Función de tabla PD_GET_DIAG_HIST

SYSPROC La función de tabla devuelve registros deanotación cronológica, registros de sucesosy registros de notificación de un recursodeterminado.


Tabla 19. Vistas y rutinas de SQL incorporadas varias (continuación)


Vista administrativaPDLOGMSGS_LAST24HOURS y función detabla PD_GET_LOG_MSGS

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.

Procedimiento REORGCHK_IX_STATSSYSPROC Este procedimiento comprueba las

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

Procedimiento REORGCHK_TB_STATSSYSPROC Este procedimiento comprueba las

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

Procedimiento SET_MAINT_MODE_RECORD_NO_TEMPORALHISTORY

SYSPROC Este procedimiento establece la opcióninterna para inhabilitar el registro delhistorial temporal para una tabla temporalde período de sistema y permite especificarvalores para las columnas temporalesespeciales.

Función escalar 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.

Procedimiento SYSINSTALLOBJECTSSYSPROC El procedimiento crea o descarta los objetos

de base de datos requeridos para unaherramienta específica.

Rutinas administrativas y procedimiento ADMIN_CMD

ADMIN_CMD – Ejecutar mandatos administrativosLas aplicaciones utilizan el procedimiento ADMIN_CMD para ejecutar mandatosadministrativos mediante la sentencia CALL de SQL.

Sintaxis

�� ADMIN_CMD ( serie-mandatos ) ��

El esquema es SYSPROC.

Parámetro del procedimiento

serie-mandatoArgumento de entrada del tipo CLOB (2M) que especifica un único mandatoque se debe ejecutar.


Autorización

Para ejecutar la rutina se requiere una de las autorizaciones siguientes:v Privilegio EXECUTE para la rutinav Autorización DATAACCESSv Autorización DBADMv Autorización SQLADM

Privilegio PUBLIC por omisión

En una base de datos no restrictiva, se concede el privilegio EXECUTE a PUBLICcuando el procedimiento se crea automáticamente.

El procedimiento da soporte actualmente a los siguientes mandatos del procesadorde línea de mandatos (CLP) de DB2:v ADD CONTACTv ADD CONTACTGROUPv AUTOCONFIGUREv BACKUP - en línea solamentev DESCRIBEv DROP CONTACTv DROP CONTACTGROUPv EXPORTv FORCE APPLICATIONv IMPORTv INITIALIZE TAPEv LOADv PRUNE HISTORY/LOGFILEv QUIESCE DATABASEv QUIESCE TABLESPACES FOR TABLEv REDISTRIBUTEv REORG INDEXES/TABLEv RESET ALERT CONFIGURATIONv RESET DATABASE CONFIGURATIONv RESET DATABASE MANAGER CONFIGURATIONv REWIND TAPEv RUNSTATSv SET TAPE POSITIONv UNQUIESCE DATABASEv UPDATE ALERT CONFIGURATIONv UPDATE CONTACTv UPDATE CONTACTGROUPv UPDATE DATABASE CONFIGURATIONv UPDATE DATABASE MANAGER CONFIGURATIONv UPDATE HEALTH NOTIFICATION CONTACT LISTv UPDATE HISTORY


Nota: Es posible que algunos mandatos tengan una sintaxis soportada ligeramentediferente cuando se ejecutan mediante el procedimiento ADMIN_CMD.

El procedimiento también da soporte a los mandatos siguientes que el CLP nosoporta:v GET STMM TUNINGv UPDATE STMM TUNING

Notas de uso

Recuperación de la información de ejecución del mandato:v Puesto que el procedimiento ADMIN_CMD se ejecuta en el servidor, también se

generan mensajes de utilidad en el servidor. La opción MESSAGES ON SERVER(consulte el mandato específico para obtener más información) indica que elarchivo de mensaje se creará en el servidor.

v El estado de la ejecución del mandato se devuelve en el área de comunicacionesSQL (SQLCA) obtenida a partir de la sentencia CALL.

v Si la ejecución del mandato administrativo es satisfactoria y el mandatodevuelve más de un estado de ejecución, la información adicional se devuelveen forma de conjunto de resultados (hasta dos conjuntos de resultados). Porejemplo, si el mandato EXPORT se ejecuta satisfactoriamente, el conjunto deresultados devuelto contiene información sobre el número de filas exportadas;sin embargo, si el mandato RUNSTATS se ejecuta satisfactoriamente, no sedevuelve ningún conjunto de resultados. La información del conjunto deresultados se documenta con el mandato correspondiente.

v Si la ejecución del mandato administrativo no es satisfactoria, el procedimientoADMIN_CMD devuelve un mensaje de aviso SQL20397W con un conjunto deresultados que contiene más detalles sobre el motivo del error del mandatoadministrativo. Cualquier aplicación que utilice el procedimiento ADMIN_CMDdebería comprobar el SQLCODE devuelto por el procedimiento. Si el SQLCODEes >= 0, se debe recuperar el conjunto de resultados del mandato administrativo.La tabla siguiente indica qué información se puede devolver, según si se utilizala opción MESSAGES ON SERVER.

Tabla 20. SQLCODE e información devueltos por el procedimiento ADMIN_CMD

Estado de ejecución delmandato administrativo

Opción MESSAGES ONSERVER especificada

Opción MESSAGES ONSERVER no especificada

Satisfactorio El SQLCODE devuelto es >=0: Información adicional(conjuntos de resultados)devuelta, si la hay.

El SQLCODE devuelto es >=0: Información adicional(conjuntos de resultados)devuelta, si la hay, pero lascolumnas MSG_RETRIEVALy MSG_REMOVAL sonNULL.

Error El SQLCODE ha devuelto20397: Información adicional(conjuntos de resultados)devuelta, pero sólo lascolumnas MSG_RETRIEVALy MSG_REMOVAL estánllenas.

El SQLCODE devuelto es <0: No se ha devueltoinformación adicional(conjuntos de resultados).

v Los conjuntos de resultados se pueden recuperar del CLP o de aplicacionescomo JDBC y CLI, pero no de aplicaciones C incorporadas.


v Los nombres sensibles a las mayúsculas y minúsculas y los nombres de juego decaracteres de doble byte (DBCS) deben incluirse entre una barra inclinadainvertida y un delimitador de comillas dobles, por ejemplo, \" Mi Tabla \".

En todos los mandatos ejecutados mediante ADMIN_CMD, el ID de usuario queestableció la conexión con la base de datos se utiliza para la autentificación.

Cualquier autorización adicional necesaria, por ejemplo para los mandatos quenecesiten acceder al sistema de archivos en el servidor de la base de datos, sedocumenta en la información de referencia que describe el mandato.

No se puede llamar a este procedimiento desde una función definida por elusuario (SQLSTATE 38001) o un activador.

Mandato ADD CONTACT utilizando el procedimiento ADMIN_CMD:

Añade un contacto a la lista de contactos que se puede definir localmente en elsistema o en una lista global. Los contactos son usuarios a los que los procesos,tales como el Planificador y el Supervisor de salud, envían mensajes.

El valor del parámetro de configuración contact_host del Servidor deadministración de bases de datos (DAS) determina si la lista es local o global.

Autorización

Ninguna

Conexión necesaria

Base de datos. El DAS debe estar en ejecución.

Sintaxis del mandato

�� ADD CONTACT nombre TYPE EMAILPAGE

MAXIMUM PAGE LENGTH longitud-pgMAX LEN

�

� ADDRESS dirección de destinatariosDESCRIPTION descripción contacto

��

Parámetros del mandato

ADD CONTACT nombreNombre del contacto que se añadirá. Por omisión, el contacto se añadirá alsistema local, a menos que el parámetro de configuración contact_host delServidor de administración de DB2 apunte a otro sistema.

TYPE Método de contacto, que debe ser uno de los dos siguientes:

EMAIL Este contacto desea recibir las notificaciones por correo electrónicoen ADDRESS).

PAGE Este contacto desea recibir las notificaciones mediante un mensajede buscapersonas enviado a ADDRESS.

MAXIMUM PAGE LENGTH longitud-pgSi el servicio de buscapersonas tiene restringida la longitudde los mensajes, se especifica aquí en caracteres.


El sistema de notificación utiliza el protocolo SMTP para enviar lanotificación al servidor de correo especificado por el parámetro deconfiguración smtp_server del Servidor de administración de DB2.Es responsabilidad del servidor SMTP enviar el correo electrónicoo llamar al buscapersonas.

ADDRESS dirección-destinatarioDirección del buzón de SMTP del destinatario. Por ejemplo,[email protected]. El parámetro de configuración smtp_server de DASdebe establecerse como el nombre del servidor SMTP.

DESCRIPTION descripción contactoTexto descriptivo del contacto. Tiene una longitud máxima de 128caracteres.

Ejemplo

Añadir un contacto para el usuario 'testuser' con la dirección de correo electrónico'[email protected]'.CALL SYSPROC.ADMIN_CMD

(’ADD CONTACT testuser TYPE EMAIL ADDRESS [email protected]’)

Notas de uso

El DAS ya se debe haber creado y estar en ejecución.

El estado de la ejecución del mandato se devuelve en el área de comunicacionesSQL (SQLCA) obtenida a partir de la sentencia CALL.

Mandato ADD CONTACTGROUP utilizando el procedimiento ADMIN_CMD:

Añade un nuevo grupo de contactos a la lista de los grupos definidos en el sistemalocal. Un grupo de contacto es una lista de usuarios y grupos a los que losprocesos de supervisión, tales como el Planificador y el Supervisor de salud,pueden enviar mensajes.

El valor del parámetro de configuración contact_host del Servidor deadministración de bases de datos (DAS) determina si la lista es local o global.

Autorización

Ninguna

Conexión necesaria

Base de datos. El DAS debe estar en ejecución.


�� ADD CONTACTGROUP nombre �

,

CONTACT nombreGROUP

�


�DESCRIPTION descripción grupo

��


ADD CONTACTGROUP nombreNombre del nuevo grupo de contacto, que debe ser exclusivo entre elconjunto de grupos del sistema.

CONTACT nombreNombre del contacto que es miembro del grupo. Se puede definir uncontacto con el mandato ADD CONTACT después de haberlo añadido a ungrupo.

GROUP nombreNombre del grupo de contactos del que este grupo es miembro.

DESCRIPTION descripción grupoOpcional. Texto descriptivo del grupo de contacto.

Ejemplo

Crear un grupo de contactos llamado 'gname1' que contenga dos contactos:'cname1' y 'cname2'.CALL SYSPROC.ADMIN_CMD( ’add contactgroup gname1 contact cname1, contact cname2’ )

Notas de uso

El DAS ya se debe haber creado y estar en ejecución.

El estado de la ejecución del mandato se devuelve en el área de comunicacionesSQL (SQLCA) obtenida a partir de la sentencia CALL.

Mandato AUTOCONFIGURE utilizando el procedimiento ADMIN_CMD:

Calcula y visualiza los valores iniciales para los parámetros del tamaño deagrupación de almacenamientos intermedios, de configuración de base de datos yde configuración de gestor de bases de datos, con la opción de aplicar los valoresmencionados.

Autorización

SYSADM

Conexión necesaria

Base de datos


�� AUTOCONFIGURE

�USING palabraclave-entrada valor-parám

�


� APPLY DB ONLYDB AND DBMNONE

ON CURRENT MEMBER��


USING palabraclave-entrada valor-parám

Tabla 21. Palabras claves de entrada y valores de parámetro válidos

Palabra claveValoresválidos

Valor poromisión Explicación

mem_percent 1-100 25 Porcentaje de memoria de instancia que seasigna a la base de datos. Sin embargo, siel mandato CREATE DATABASE invoca alasesor de configuración y no se especificaun valor para mem_percent, el porcentaje secalcula en función del uso de memoria dela instancia y del sistema hasta un máximodel 25% de la memoria de instancia.

workload_type simple,mixed,complex

mixed Las cargas de trabajo sencillas tienden atener una actividad intensiva de E/S yprincipalmente de transacciones, mientrasque las cargas de trabajo complejas tiendena tener una actividad intensiva de CPU yprincipalmente de consultas.

num_stmts 1-1.000.000 10 Número de sentencias por unidad detrabajo

tpm 1-200.000 60 Transacciones por minuto

admin_priority performance,recovery,both

both Optimizar para obtener un rendimientomejor (más transacciones por minuto) o untiempo de recuperación mejor

is_populated yes, no yes ¿Hay datos en la base de datos?

num_local_apps 0-5.000 0 Número de aplicacio

rutinas y vistas administrativaspublic.dhe.ibm.com/ps/products/db2/info/vr101/pdf/es_es/...una...

Documents