Los registros de servicio son anotaciones escritas en formato binario. Un registro de servicio no se puede ver directamente utilizando un editor de texto. Nunca se deberá editar directamente el registro de servicio, pues ello corrompería el registro.
Antes de empezar
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Para mover un registro de servicio de una máquina a otra,
hay que utilizar un mecanismo que soporte la transferencia de archivos binarios como, por ejemplo, FTP. Utilice la herramienta Showlog para convertir el contenido de un registro de servicio en un formato de texto que luego pueda escribirse en un archivo o volcarse
en la ventana del shell del comandos.
Se puede ver un registro de servicio utilizando
la herramienta Showlog para convertir el contenido de dicho registro en un formato de texto
que luego pueda escribirse en un archivo o volcarse en la ventana del shell del comandos.
Acerca de esta tarea
Ejecute el script showlog para ver el contenido del registro de servicio, tal como se
describe en el procedimiento siguiente.
Procedimiento
- Abra una ventana de shell en la máquina donde resida el registro de servicio.
- Vaya al directorio raíz_servidor_apl/bin donde raíz_servidor_apl es la ruta completa donde está instalado el producto WebSphere Application Server.
- Ejecute el script showlog.
showlog.bat
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
showlog.sh
showlog
![[z/OS]](../images/ngzos.gif)
Utilice el formato siguiente:
showlog.sh {-start fechaHoraInicio [-end fechaHoraFin] | -interval intervalo}
[-format CBE-XML-1.0.1] [-encoding codificación] nombreCorrienteAnotaciones
[nombreArchivoSalida]
donde:
- -start
- Especifica la fecha y hora de inicio en el formato aaaa-MM-ddTHH:mm:ss.SSSZ. Los milisegundos y el huso horario son opcionales.
- -end
- Especifica la fecha y hora de finalización en el formato aaaa-MM-ddTHH:mm:ss.SSSZ.
Los milisegundos y el huso horario son opcionales.
- -interval
- Especifica la fecha de inicio como la fecha y hora del sistema menos
los milisegundos del intervalo, y la fecha final como la fecha y hora del
sistema. Son valores válidos los enteros mayores que 0.
- -format
- Especifica el formato de la salida. Actualmente solo se soporta el
formato CBE-XML-1.0.1 (compatible con la especificación Common Base
Event versión 1.0.1). Si no se proporciona ningún formato, la salida de
showlog tendrá formato tabular.
- -encoding
- Especifica la codificación del archivo de salida, una codificación de caracteres
soportada por la JVM (Java™ Virtual Machine) local.
- nombreCorrienteAnotaciones
- Es el nombre de un archivo de anotaciones cronológicas.
- nombreArchivoSalida
- Es opcional. Si no se proporciona ningún nombre de archivo, el script showlog crea el nombre de archivo predeterminado showlog.out, nombreArchivoSalida se crea en el directorio actual a menos que sea un nombre de archivo totalmente cualificado.
El contenido formateado del registro cronológico de servicio se escribe siempre en un archivo.
Existen parámetros de showlog.sh que controlan el contenido y la
codificación de la salida. Escriba showlog.sh sin parámetros para obtener la información de uso de los parámetros.
El script showlog puede devolver
mensajes informativos que contengan nombres de servicio, códigos de
retorno y códigos de razón. Para obtener más información sobre el uso de la corriente de anotaciones cronológicas
de z/OS o
para buscar nombres de servicio, códigos de retorno o códigos de razón, consulte
la Referencia ENF-IXG(SA22-7610) de servicios de ensamblador autorizados de z/OS MVS.
Se enumeran los códigos
de retorno y de razón de todos los servicios.
Consulte el tema "Autorización de programas de aplicación de registrador de sistemas" en la Guía de servicios de ensamblador de z/OS MVS (SA22-7605) para obtener pautas sobre cómo permitir el acceso a la corriente de anotaciones cronológicas.
- Ejecute el siguiente script showlog sin parámetros para visualizar las instrucciones de uso.
showlog.bat
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[AIX]](../images/aixlogo.gif)
showlog.sh
showlog
showlog.sh
Visualice el contenido del registro de servicio en la ventana de shell. showlog nombrearchivo_registro_servicio
Si el registro de
servicio no se encuentra en la ubicación predeterminada, hay que indicar el
nombre_archivo_registro_servicio completo.
- Dé formato al contenido del registro de servicio y escríbalo en un archivo.
showlog nomnbrearchivo_registro_servicio nombrearchivo_salida
Si el registro de
servicio no se encuentra en la ubicación predeterminada, hay que indicar el
nombre_archivo_registro_servicio completo.
![[z/OS]](../images/ngzos.gif)
Ejemplo
A continuación se muestran ejemplos de scripts showlog en sistemas z/OS
- Para escribir todos los registros del archivo WAS.ERROR.LOG desde el 14 de julio de
2004 en formato de analizador de registro cronológico en el archivo myoutput.log, utilice el formato siguiente:
showlog.sh -start 2004-07-14T00:00:00 WAS.ERROR.LOG myoutput.log
- Para escribir todos los registros del archivo WAS.ERROR.LOG desde el 14 de julio de 2004 en formato
Common Base Event XML 1.0.1 en el archivo myoutput.log, utilice el formato siguiente:
showlog.sh -start 2004-07-14T00:00:00 -format CBE-XML-1.0.1
WAS.ERROR.LOG myoutput.log
- Para escribir todos los registros del archivo WAS.ERROR.LOG entre el 14 de julio de
2004 y el 9 de abril de 2005 en formato Common Base Event XML 1.0.1 en el archivo myoutput.log, utilice el formato siguiente:
showlog.sh -start 2004-07-14T00:00:00 -end 2005-04-09T00:00:00
-format CBE-XML-1.0.1 WAS.ERROR.LOG myoutput.log
- Para escribir todos los registros del archivo WAS.ERROR.LOG desde el 6 de diciembre de
2004 a las 9 pm de la hora estándar del Este (EST) en el archivo myoutput.log (el archivo de salida predeterminado), utilice el formato siguiente:
showlog.sh -start 2004-12-06T21:00:00EST WAS.ERROR.LOG