Apéndice A. Archivos de propiedades de unidad ejecutable

Los valores de unidad ejecutable, como los valores de anotaciones cronológicas, de rastreo y de licencia, se almacenan en uno de dos archivos diferentes:

Si desea obtener más información sobre cómo administrar los valores del tiempo de ejecución para aplicaciones Web, consulte Administración de componentes de la determinación de problemas. Si desea obtener más información sobre cómo administrar los valores del tiempo de ejecución para aplicaciones de cliente enriquecido, consulte Administración de aplicaciones de cliente enriquecido de HATS.

Los archivos runtime.properties y runtime-debug.properties contienen las propiedades siguientes.

adminPortNum
adminPortNum es el valor por omisión que utiliza la consola administrativa de HATS cuando se va a cambiar el ámbito de gestión. El valor de puerto debe ser un puerto activo BOOTSTRAP_ADDRESS de WebSphere. El valor por omisión es 2809, que es el puerto BOOTSTRAP_ADDRESS por omisión de server1 para una instalación base de WebSphere o del servidor del agente de nodo cuando integra un nodo del servidor de aplicaciones en una célula del gestor de despliegue.
ioPatternKey Sólo Web 
Uno o más patrones que especifican los objetos de integración que se van a rastrear. Consulte la descripción de trace.INTEGRATIONOBJECT más abajo.

Cada patrón puede contener un carácter comodín (*) o más. Por ejemplo, IntegrationObject.Callup* especifica que está habilitado el rastreo para todos los objetos de integración que empiezan por las letras Callup. Para efectuar el rastreo de todos los objetos de integración, especifique IntegrationObject.*

Si se especifican varios patrones, deben delimitarse con comas.

numLicenses
Especifica el número de licencias adquiridas. HATS hace un seguimiento del número de conexiones de HATS con recursos del sistema principal y anota un mensaje cuando el valor excede el número de licencias adquiridas.

El valor es un entero. No hay ningún valor por omisión. Los valores válidos para las licencias de Usuario autorizado son 1 - 50000. Para las licencias de Unidad de valor, el valor de ser -1.

licenseHardLimit
Campo cifrado que contiene título de licencia de HATS. No modifique manualmente este campo.
licenseTracking
Especifica si HATS registra el uso de licencias o no. El valor es binario. El valor por omisión es 0.
0
HATS no registra el uso de licencias.
1
HATS registra el uso de licencias para todos los servidores de aplicaciones de un nodo. HATS hace un seguimiento del número de conexiones de HATS con recursos del sistema principal o de la base de datos y anota un mensaje cuando el valor excede el número de licencias adquiridas. La información de uso de licencias se escribe en el archivo x.txt del directorio log del directorio de instalación de HATS del servidor, donde x es 1 ó 2.

El tamaño máximo del archivo de uso de licencias es 512 KB. Cuando el tamaño del archivo license1.txt alcanza los 512 KB o si se reinicia el servidor de HATS, el archivo pasa a denominarse license2.txt y se crea un nuevo archivo license1.txt. El nuevo archivo license1.txt contiene la información de uso de licencias más reciente. Cuando el nuevo archivo license1.txt alcanza el tamaño de 512 KB y su nombre cambia, se suprime el archivo license2.txt antiguo.

Los archivos de uso de licencias contienen la siguiente información, dispuesta en filas, en donde cada fila representa una hora de funcionamiento. Los valores se separan mediante un espacio ( ).

  1. Fecha
  2. Hora
  3. El número de licencias más alto desde que se inició el servidor
  4. El número de licencias más alto en la última hora (el máximo de las últimas 60 entradas)
  5. El número de licencias para cada minuto (1-60)
licenseFile
Nombre utilizado como plantilla para generar nombres para los archivos de licencia para la información de uso de licencias. El valor por omisión de esta propiedad es license.txt.
logFile
Nombre utilizado como plantilla para generar nombres para cada conjunto de archivos del servidor de aplicaciones en los que se escriben los mensajes de anotaciones cronológicas. El nombre base por omisión del archivo de anotaciones cronológicas es messages.txt.
maxLogFiles
Número máximo de archivos de mensajes. El valor por omisión es 2.

El nombre del archivo de anotaciones cronológicas base en runtime.properties se utiliza como plantilla para generar conjuntos exclusivos de archivos de anotaciones cronológicas de mensajes para cada servidor de aplicaciones. El nombre base por omisión para un archivo de anotaciones cronológicas puede cambiarse en el archivo runtime.properties. El servidor de aplicaciones que ejecuta HATS es la concatenación del carácter de subrayado (_) seguido del nombre de la instancia de HATS y de otro carácter de subrayado (_).

El ID de la instancia de HATS (por ejemplo, _SSS_) se añade al nombre de archivo base para generar la plantilla para los archivos de anotaciones cronológicas de un servidor de aplicaciones. Para el archivo de anotaciones cronológicas, éste pasa a ser messages_SSS_.txt. Por último, se añade a este nombre un índice (1, 2, 3, etc.) para distinguir entre varios archivos. Por ejemplo, si el ID de la instancia de HATS es célula_nodo_servidor, el archivo de anotaciones cronológicas del servidor de aplicaciones se denomina messages_célula_nodo_servidor_.txt. Con varios archivos de anotaciones cronológicas configurados, los nombres de los archivos de anotaciones cronológicas de este servidor de aplicaciones son messages_célula_nodo_servidor_1.txt, messages_célula_nodo_servidor_2.txt, etc.

Cuando messages_célula_nodo_servidor_1.txt alcanza el valor indicado en maxLogFileSize, se cierra y renombra como messages_célula_nodo_servidor_2.txt. Se abre un nuevo archivo messages_célula_nodo_servidor_1.txt.

Cuando el archivo messages_célula_nodo_servidor_1.txt vuelve a alcanzar el valor indicado en maxLogFileSize, se cambia el nombre de los archivos de anotaciones cronológicas anteriores; por ejemplo messages_célula_nodo_servidor_2.txt pasa a ser messages_célula_nodo_servidor_3.txt. A continuación, messages_célula_nodo_servidor_1.txt pasa a ser messages_célula_nodo_servidor_2.txt y se abre un nuevo archivo messages_célula_nodo_servidor_1.txt.

Cuando se supera el número de maxLogFiles, se suprime el archivo más antiguo.

Nota:
cuando se ejecuta en WebSphere Application Server para z/OS, la parte servidor del nombre del archivo de anotaciones cronológicas también incluye el ID del espacio de direcciones del proceso subordinado que está escribiendo en el archivo (por ejemplo: messages_asid_1.txt). Si desea obtener más información, consulte Nombres de archivos de anotaciones cronológicas y de rastreo.
maxLogFileSize
Especifica el tamaño máximo, en kilobytes, que alcanza el archivo de anotaciones cronológicas antes de abrir un archivo de anotaciones cronológicas adicional.

El valor es un entero. El valor por omisión es 512 KB.

traceFile
Nombre utilizado como plantilla para generar nombres de archivo en los que se escriben los mensajes de rastreo de HATS. El nombre base por omisión del archivo de rastreo es trace.txt.
maxTraceFiles
Número máximo de archivos de información de rastreo. El valor por omisión es 5.

El nombre del archivo de rastreo base en server.properties se utiliza como plantilla para generar conjuntos exclusivos de archivos de rastreo para cada servidor de aplicaciones. El nombre base por omisión para un archivo de rastreo puede cambiarse en el archivo runtime.properties. El servidor de aplicaciones que ejecuta HATS es la concatenación del carácter de subrayado (_) seguido del nombre de la instancia de servidor de HATS y de otro carácter de subrayado (_).

El ID de la instancia de servidor de HATS (por ejemplo, _SSS_) se añade al nombre de archivo base para generar la plantilla para los archivos de rastreo de un servidor de aplicaciones, que se convierte en trace_SSS_.txt. Por último, se añade un índice (1, 2, 3, etc.) a este nombre para distinguir entre varios archivos de rastreo. Por ejemplo, si el ID de la instancia de servidor de HATS es célula_nodo_servidor, el archivo de rastreo del servidor de aplicaciones se denomina trace_célula_nodo_servidor_.txt. Con varios archivos de rastreo configurados, los nombres de archivo de rastreo para este servidor de aplicaciones son trace_célula_nodo_servidor_1.txt, trace_célula_nodo_servidor_2.txt, etc.

Cuando trace_célula_nodo_servidor_1.txt alcanza el valor indicado en maxTraceFileSize, se cierra y renombra como trace_célula_nodo_servidor_2.txt. Se abre un nuevo archivo trace_célula_nodo_servidor_1.txt.

Cuando el archivo trace_célula_nodo_servidor_1.txt vuelve a alcanzar el valor indicado en maxTraceFileSize, se cambia el nombre de los archivos de rastreo anteriores; por ejemplo trace_célula_nodo_servidor_2.txt pasa a ser trace_célula_nodo_servidor_3.txt. A continuación, trace_célula_nodo_servidor_1.txt pasa a ser trace_célula_nodo_servidor_2.txt y se abre un nuevo archivo trace_célula_nodo_servidor_1.txt.

Cuando se supera el número de maxTraceFiles, se suprime el archivo más antiguo.

Nota:
cuando se ejecuta en WebSphere Application Server para z/OS, la parte servidor del nombre del archivo de rastreo también incluye el ID del espacio de direcciones del proceso subordinado que está escribiendo en el archivo (por ejemplo: trace_asid_1.txt). Si desea obtener más información, consulte Nombres de archivos de anotaciones cronológicas y de rastreo.
maxTraceFileSize
Especifica el tamaño máximo, en kilobytes, que alcanza el archivo de rastreo antes de abrir un archivo de rastreo adicional.

El valor es un entero. El valor por omisión es 10240 KB.

traceLogDirectory
Establece el directorio que se va a utilizar para escribir la salida de anotaciones cronológicas y de rastreo al desplegar el EAR de aplicación. Si no se especifica esta palabra clave o el valor especificado no es válido, el directorio utilizado será logs, y estará ubicado bajo el directorio de instalación del EAR. Este valor sólo se utilizará si el EAR se despliega en un servidor de aplicaciones. No tiene efecto en el entorno de Toolkit.
maxHODThreadManagerThreads
Especifica el número máximo de hebras que se pueden crear en la agrupación de hebras de ThreadManager de Host On-Demand. Puede especificar un valor entre 10 y 10000. Si especifica un valor fuera de este intervalo, se pasa por alto el valor y se utiliza el valor por omisión 10000 de Host On-Demand.

Opciones de rastreo

Los valores de nivel de rastreo utilizados por las opciones de rastreo descritas en esta sección representan una serie de dígitos hexadecimales. Cada bit de la serie de dígitos controla un tipo de rastreo para la unidad ejecutable. Los valores por omisión son:

tracelevel.1 : 0000000000020000
tracelevel.2 : 000000000000020f
tracelevel.3 : 000000000004023f  (mínimo)
tracelevel.4 : 0000000000041a3f
tracelevel.5 : 00000000000c1bbf  (normal)
tracelevel.6 : 00000000000c1bbf
tracelevel.7 : 00000000001c1bbf  (máximo)
tracelevel.8 : 00000000001c1bbf
tracelevel.9 : 00000000001c1bbf

A continuación se muestran las definiciones de cada bit en la máscara de rastreo:

x000001  - Mensajes informativos
x000002  - Mensajes de aviso
x000004  - Mensajes de error
x000008  - Mensajes de error crítico
x000010  - Rastreos de API
x000020  - Rastreos de API de respuesta
x000080  - Entrada de método
x000100  - Salida de método
x000200  - Excepciones
x000400  - Rastreos adicionales
x000800  - Creación de objeto
x001000  - Disposición de objeto
x020000  - Rastreo de rendimiento - usar este valor sn solitario
x040000  - Datos adicionales - nivel 1
x080000  - Datos adicionales - nivel 2
x100000  - Datos adicionales - nivel 3

Para personalizar los valores de nivel de rastreo, añada los valores hexadecimales en la máscara de rastreo. Por ejemplo, si especifica tracelevel.9=180 y después utiliza trace.RUNTIME=9, sólo se realizarán los rastreos de unidad ejecutable de entrada de método y de salida de método.

trace.RUNTIME
Especifica el nivel de rastreo de la unidad ejecutable principal y de todos los valores bajo RUNTIME.* que no especifican un nivel de rastreo.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de la unidad ejecutable.

trace.RUNTIME.ACTION
Especifica el nivel de rastreo de las acciones de sucesos. Este valor prevalece sobre el valor de trace.RUNTIME.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de sucesos.

trace.TRANSFORM
Especifica el nivel de rastreo de las transformaciones de HATS y de todos los valores bajo TRANSFORM.* que no especifiquen un nivel de rastreo.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de transformaciones.

trace.TRANSFORM.COMPONENT
Especifica el nivel de rastreo de componentes de HATS. Este valor prevalece sobre el valor de trace.TRANSFORM.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de componentes.

trace.TRANSFORM.WIDGET
Especifica el nivel de rastreo de aparatos de HATS. Este valor prevalece sobre el valor de trace.TRANSFORM.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de aparatos.

trace.INTEGRATIONOBJECT Sólo Web 
Especifica el nivel de rastreo para los objetos de integración.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo de componentes.

trace.UTIL
Especifica el nivel de rastreo de programas de utilidad de tiempo de la unidad ejecutable de HATS.

El valor es un entero entre 0 y 9. El valor por omisión es 0, lo que significa que no se lleva a cabo ningún rastreo del programa de utilidad de la unidad ejecutable.

trace.APPLET Sólo Web 
Especifica el nivel de rastreo del applet.

El valor es un entero, donde

0
No se lleva a cabo ningún rastreo.
3
Se lleva a cabo el nivel mínimo de rastreo.
5
Se lleva a cabo el nivel normal de rastreo.

El valor por omisión es 0.

Rastreo Host On-Demand

trace.HOD.COMMEVENT
Especifica el nivel de rastreo de los sucesos COMM de Host On-Demand.
0
El rastreo de sucesos COMM de Host On-Demand no está habilitado.
1
El rastreo de sucesos COMM de Host On-Demand está habilitado.

El valor es binario. El valor por omisión es 0.

trace.HOD.DISPLAYTERMINAL
Especifica si Host On-Demand muestra una ventana de terminal para cada conexión.
0
Host On-Demand no muestra una ventana de terminal para cada conexión.
1
Host On-Demand muestra una ventana de terminal para cada conexión.

El valor es binario. El valor por omisión es 0.

Si trace.HOD.DISPLAYTERMINAL es 1, cuando HATS crea una conexión de sistema principal (por ejemplo, en respuesta a una petición de una aplicación), crea automáticamente una pantalla de terminal de sistema principal. Si esta propiedad tiene el valor 0, esto no sucede. Sin embargo, tanto si la pantalla de terminal de sistema principal se crea automáticamente durante la creación de la conexión de sistema principal como si no se crea, un administrador de HATS puede utilizar la consola administrativa de HATS para activar o desactivar pantallas de terminal de sistema principal para conexiones de sistema principal individuales.

trace.HOD.DS
Especifica el nivel de rastreo del rastreo de la corriente de datos de Host On-Demand.

El valor es un entero entre 0 y 3, donde:

0
No se lleva a cabo ningún rastreo.
1
Se lleva a cabo el nivel mínimo de rastreo.
2
Se lleva a cabo el nivel normal de rastreo.
3
Se lleva a cabo el nivel máximo de rastreo.

El valor por omisión es 0.

trace.HOD.MACRO
Especifica el nivel de rastreo de las macros de Host On-Demand.

El valor es un entero entre 0 y 2, donde:

0
El rastreo de macros de Host On-Demand no está habilitado.
1
El rastreo de sucesos de Host On-Demand está habilitado.
2
El rastreo del soporte de Host On-Demand está habilitado.

El valor por omisión es 0.

trace.HOD.PS
Especifica el nivel de rastreo del espacio de presentación de Host On-Demand.

El valor es un entero entre 0 y 3, donde:

0
No se lleva a cabo ningún rastreo.
1
Se lleva a cabo el nivel mínimo de rastreo.
2
Se lleva a cabo el nivel normal de rastreo.
3
Se lleva a cabo el nivel máximo de rastreo.

El valor por omisión es 0.

trace.HOD.PSEVENT
Especifica el nivel de rastreo de los sucesos PS de Host On-Demand.
0
El rastreo de sucesos PS de Host On-Demand no está habilitado.
1
El rastreo de sucesos PS de Host On-Demand está habilitado.

El valor es binario. El valor por omisión es 0.

trace.HOD.OIAEVENT
Especifica el nivel de rastreo de sucesos de OIA de Host On-Demand.
0
El rastreo de sucesos de OIA de Host On-Demand no está habilitado.
1
El rastreo de sucesos de OIA de Host On-Demand está habilitado.

El valor es binario. El valor por omisión es 0.

trace.HOD.SESSION
Especifica el nivel de rastreo de las sesiones de Host On-Demand.

El valor es un entero entre 0 y 3, donde:

0
No se lleva a cabo ningún rastreo.
1
Se lleva a cabo el nivel mínimo de rastreo.
2
Se lleva a cabo el nivel normal de rastreo.
3
Se lleva a cabo el nivel máximo de rastreo.

El valor por omisión es 0.

trace.HOD.TRANSPORT
Especifica el nivel de rastreo para el transporte de Host On-Demand.

El valor es un entero entre 0 y 3, donde:

0
No se lleva a cabo ningún rastreo.
1
Se lleva a cabo el nivel mínimo de rastreo.
2
Se lleva a cabo el nivel normal de rastreo.
3
Se lleva a cabo el nivel máximo de rastreo.

El valor por omisión es 0.

trace.HOD.USERMACRO
Especifica el nivel de rastreo de las acciones de rastreo en las macros de usuario de Host On-Demand.

El valor es un entero entre 0 y 3, donde:

0
No se lleva a cabo ningún rastreo.
1
Se lleva a cabo el nivel mínimo de rastreo.
2
Se lleva a cabo el nivel normal de rastreo.
3
Se lleva a cabo el nivel máximo de rastreo.

El valor por omisión es 0.

Rastreo de simulación de sistema principal

recordSimulationTrace
Especifica si la grabación del rastreo de simulación de sistema principal se habilita en tiempo de ejecución.
0
La grabación del rastreo de simulación de sistema principal no está habilitada.
1
La grabación del rastreo de simulación de sistema principal está habilitada.

El valor es binario. El valor por omisión es 0.

startPort
Especifica el punto de inicio del rango de puertos que se va a utilizar durante la ejecución para realizar la grabación del rastreo de simulación del sistema principal para varias sesiones del sistema principal de forma simultánea. El valor por omisión es el puerto 7021.
endPort
Especifica el punto de fin del rango de puertos que se va a utilizar durante la ejecución para realizar la grabación del rastreo de simulación del sistema principal para varias sesiones del sistema principal de forma simultánea. El valor por omisión es el puerto 7050.