Soporte de nombres de archivo dinámicos

Utilice el soporte de nombres de archivo dinámicos para especificar un patrón de nombre de archivo en lugar de un nombre de archivo real.

Algunos programas de aplicación crean un nombre de archivo de salida que está sujeto a cambios. El nombre cambia en función de criterios específicos como el día, mes o año actual, o un nombre de archivo que incluye un número de secuencia incremental. En estos casos, puede especificar el patrón de nombre de archivo e lugar del nombre de archivo real. Existen dos formatos de patrón que se reconocen al especificar el patrón del nombre de archivo:
  • Expresiones regulares (preferido).
  • Sintaxis de nombres de archivo dinámicos de IBM® Tivoli Universal Agent (en desuso).

Patrones de nombres de archivo de expresiones regulares

Para especificar patrones de nombres de archivo, puede utilizar expresiones regulares según la sintaxis ICU (International Components for Unicode) que se documenta en el Expresiones regulares de ICU. Para utilizar esta capacidad, debe marcar el recuadro de selección Los nombres de archivos coinciden con expresiones regulares en la página Información avanzada de grupo de atributos de archivo de registro. Al especificar patrones de expresiones regulares, también debe seleccionar una opción en la lista Cuando coinciden varios archivos de la página Información avanzada de grupo de atributos de archivo de registro para especificar las directrices para seleccionar el archivo coincidente más actual.

Nota: Las expresiones regulares son el método preferido para especificar patrones de nombres de archivos.

Para obtener más información sobre cómo configurar propiedades avanzadas de atributos de archivo de registro, consulte Supervisión de un archivo de registro, paso 6. Por ejemplo, si ha especificado un patrón de nombre de archivo:

d:\program files\logs\tivoli.*

Este patrón busca nombres de archivo que empiezan por tivoli en el directorio d:\program files\logs. Las expresiones regulares se pueden especificar sólo para la parte de nombre de archivo, no para el nombre de vía de acceso.

Sintaxis de nombres de archivos dinámicos

Con la sintaxis de nombres de archivo dinámicos, sólo se puede supervisar un archivo cada vez. El proveedor de datos de archivo inspecciona todos los archivos de la ubicación de vía de acceso asignada, buscando los archivos que coincidan con el patrón definido. El proveedor de datos de archivo siempre supervisa el archivo coincidente más actual que se basa en el nombre de archivo coincidente que tenga el número o valor de fecha/hora más alto. El archivo adecuado que supervisar viene determinado por el nombre de archivo, en lugar de por la creación de archivo u otros criterios.

Se pueden especificar patrones para nombres de archivo con cualquier número de partes. Por ejemplo, Log{###} coincide con nombres de archivo de una parte, como Log010 o Log456. En nombres de archivo de varias partes, se pueden especificar caracteres de patrón en cualquier parte del nombre de archivo o en varias partes. Por ejemplo, aaa.bbb{???}.ccc es un patrón válido y aaa.bbb{???}.ccc{###} también es válido.

Nota: Las expresiones regulares son el método preferido, más que la sintaxis de nombres de archivo dinámicos, para especificar patrones de nombre de archivo. Para obtener más información sobre las expresiones regulares, consulte Patrones de nombres de archivo de expresiones regulares

Los siguientes ejemplos ilustran la especificación de patrón de nombre de archivo:

{########}.abc
Coincide con nombres de archivo numéricos de longitud 8 y la extensión de archivo .abc, como 10252006.abc o 10262006.abc. El archivo 10262006.abc se supervisa porque 10262006 es mayor que 10252006.
{########}.*
Coincide con nombres de archivo numéricos de longitud 8 e ignora la extensión de archivo. Entre los ejemplos se incluyen 20061025.log, 20061101.log y 10252006.abc. El archivo 20061101.log se supervisa porque 20061101 es el número más grande.
{######??}.abc
Coincide con nombres de archivo numéricos de longitud 8 y la extensión de archivo .abc, e ignora las dos últimas posiciones de la parte del nombre. Entre los ejemplos se incluyen 02110199.abc, 02110200.abc y 021101AZ.abc. El archivo 02110200.abc se supervisa porque 021102 es el número más grande.
Console.{######}
Coincide con nombres de archivo que contienen Console en la parte del nombre y un número de seis dígitos en la parte de la expresión. Entre los ejemplos se incluyen Console.000133, Console.000201 y Console.000134. El archivo Console.000201 se supervisa.
IN{######}.log
Coincide con nombres de archivo que empiezan por IN seguido de seis números y la extensión de archivo .log. Entre los ejemplos se incluyen IN021001.log, IN021002.log y IN021004.log. Se supervisa el archivo IN021004.log.
PS{###}FTP.txt
Coincide con nombres de archivo que empiezan por PS seguido de tres números, seguidos por FTP y la extensión .txt. Entre los ejemplos se incluyen PS001FTP.txt, PS005FTP.txt y PS010FTP.txt. El archivo PS010FTP.txt se supervisa.
Siga estas directrices para establecer patrones de nombres de archivo:
  • Utilice llaves {} para encerrar los caracteres de patrón en un nombre de archivo. La presencia de caracteres de patrón dentro de llaves indica que se utiliza un patrón de nombre de archivo.
  • Utilice un asterisco (*) como carácter comodín para ignorar extensiones de archivo o los caracteres de cola del nombre de archivo. Por ejemplo, Myapp{###}.log* especifica que cualquier nombre que empiece por Myapp, seguido de tres dígitos y de .log es una coincidencia, independientemente de lo que vaya después.

    El asterisco se debe especificar después de las llaves ({ }) y no se puede utilizar al principio de un nombre de archivo. Cuando utiliza el asterisco en una extensión de nombre de archivo, el asterisco debe utilizarse solo.

    Ejemplos de uso correcto del comodín (*):
    err{??}.*
    error{$}.*
    Ejemplos del uso incorrecto del comodín (*):
    error.20*
    Ninguna llave precede al asterisco (*).
    error*.{###}
    El asterisco no se utiliza al final del nombre de archivo.
    error.*
    Ninguna llave precede al asterisco (*).
  • Si se define una extensión de archivo específica, sólo se tendrán en cuenta los archivos con la misma extensión.
  • Utilice un signo de número para indicar cada elemento numérico de un nombre de archivo.
  • Utilice un signo de interrogación para excluir cada elemento del convenio de denominación que no sirva como criterio de búsqueda a la hora de determinar el nombre de archivo correspondiente.
  • Utilice un signo de dólar ($) para representar cualquier carácter o ningún carácter. Por ejemplo, si desea la coincidencia con dos archivos llamados Log y LogA, especifique Log{$}. El signo de dólar tiene varias restricciones de uso. Cuando utiliza uno o más signos de dólar como prefijo de un nombre de archivo como, por ejemplo, {$$$$$$}_abc.log, el número de signos de dólar debe coincidir exactamente con el número de caracteres en esa posición en el nombre de archivo. Además, no se pueden especificar signos de dólar en varias ubicaciones de un patrón de nombre de archivo, por ejemplo, {$$$}b{$$$}.log no coincide con abc.log. Dadas estas restricciones del signo de dólar, utilice patrones de nombre de archivo de expresión regular si hay un número indeterminado de caracteres en los nombres de archivo.
  • El número total de signos de número y de interrogación que están especificados entre llaves es significativo. Debe coincidir con la parte del nombre de archivo con exactitud. Por ejemplo, el patrón AA{####} indica al proveedor de datos de archivo que busque archivos como AA0001. Lo nombres de archivo, como AA001 o AA00001, no se toman en consideración.
  • El patrón de nombre de archivo exacto, las partes constantes y las numéricas deben coincidir con el nombre de archivo de forma exacta. Por ejemplo, el patrón AA{###} indica al proveedor de datos de archivo que compruebe el archivo AA101. Los nombres de archivo, como XAA101, AA222X y AA55555, no se toman en consideración.
  • Utilice la cadena de patrón reservado {TIVOLILOGTIME} para sustituir la indicación de fecha y hora y el número de secuencia del archivo en un agente de Tivoli Monitoring o un archivo de registro de servidor. Esta cadena de patrón es útil cuando se realiza la supervisión automática de componentes de Tivoli Monitoring. Por ejemplo, si desea supervisar el último registro del servidor de supervisión en el directorio /opt/IBM/ITM/logs, puede especificar un patrón de nombre de archivo: 
    /opt/IBM/ITM/logs/Host1_ms_{TIVOLILOGTIME}.log
    Si Host1_ms_452053c0-01.log, Host1_ms_451f11f4-01.log, Host1_ms_45205946-01.log y Host1_ms_451f11f4-02.log están presentes en el directorio /logs, el archivo Host1_ms_45205946-01.log se selecciona para supervisión.

Para especificar de forma precisa un nombre de archivo que consta de componentes de fecha (año, mes y día), utilice las letras mayúsculas Y, M y D. Estas letras deben especificarse entre llaves; de lo contrario se tratan como caracteres literales del nombre de archivo.

Vea los siguientes ejemplos:

{YYYYMMDD}.log
Especifica nombres de archivo como 20060930.log o 20061015.log.
{MMDDYY}.log
Especifica nombres de archivo como 101106.log o 110106.log.
{DDMMYYYY}.log
Especifica nombres de archivo como 01092006.log o 15082006.log.
{DDMMMYY}.log
Especifica nombres de archivo como 24Jan07 o 13Sep06.
{MM-DD-YY}.log
Especifica nombres de archivo como, por ejemplo, 11-02-06 o 04-29-07. El carácter separador (-) se ignora en el campo de fecha y no requiere un carácter de patrón de signo de interrogación para saltárselo.
MY{YYDDD}.log
Especifica nombres de archivo como MY06202.log, MY06010.log o MY04350.log.

Existen casos complejos, en los que un campo de datos se incluye dentro de un nombre de archivo más largo, y los patrones de fecha en los ejemplos anteriores no son suficientes. Para casos complejos, se crean patrones que combinen los signos de número y los interrogantes, y se siguen realizando comparaciones numéricas que seleccionen el archivo más actual para la supervisión. Por ejemplo, el patrón ABC{?####?##?##?##?##?##?}XYZ.TXT se puede utilizar para nombres de archivo como ABC 2006-04-20 11_22_33 XYZ.TXT. En este ejemplo, solo está interesado en los dígitos marcados con #- y los signos de interrogación sirven de marcadores para ignorar otros caracteres del nombre de archivo.

El proveedor de datos de archivo comprueba periódicamente si hay archivos nuevos que coincidan con el patrón de archivo definido en la ubicación de vía de acceso de destino. Cuando se detecta un archivo nuevo que coincida con el patrón, el proveedor de datos de archivo cambia automáticamente la supervisión de la aplicación al nuevo archivo. El proveedor de datos de archivo busca el archivo que mejor coincida cuando:
  • El proveedor de datos de archivo se inicia por primera vez.
  • El archivo supervisado actualmente ya no existe debido a posibles renombres o supresiones.
  • El contenido del archivo existente ha cambiado debido a posibles reescrituras.
  • El intervalo de comprobación ha caducado. El intervalo predeterminado es 10 minutos. Puede cambiar el intervalo a un valor de intervalo más largo o más corto especificando la variable de entorno 
    KUMP_DP_FILE_SWITCH_CHECK_INTERVAL=número-de-segundos