4 Comandos del operador del servidor de la XAPI de XCMD

En este capítulo, se describen los comandos del operador del servidor de la XAPI admitidos por XCMD. Estos comandos le permiten a un operador o administrador supervisar el componente XAPI de ACSLS. Los comandos admitidos incluyen:

Ejecute estos comandos desde user_proc de ACSLS utilizando el comando XCMD. Consulte Convenciones de comandos XCMD para obtener más información.

Consulte Convenciones de sintaxis para obtener información sobre las convenciones utilizadas en los diagramas de flujo de sintaxis incluidos en las secciones de comandos a continuación.

LOG

En la siguiente sección, se describe el comando LOG.

Descripción

El comando LOG cambia o muestra la configuración de log actual del servidor de la XAPI.

Nota:

Las variables de entorno de ACSLS establecen el nombre y la ubicación del archivo log, cuyos valores por defecto son el nombre de archivo vlog.file y el directorio XAPI_WORK_PATH.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando LOG:

Figura 4-1 Sintaxis del comando LOG

El texto adyacente describe Figura 4-1 .

Parámetros

Como se muestra en la Figura 4-1, el comando LOG incluye los siguientes parámetros:

LIst

De manera opcional, especifica que se muestre la configuración de log actual. Si no se especifican parámetros de comando, el valor por defecto es LIst.

log_setting

De manera opcional, indica la configuración de log deseada como una serie de caracteres "0" y "1".

  • 0 significa que la configuración de log posicional deseada debe ser OFF o desactivado.

  • 1 significa que la configuración de log posicional deseada debe ser ON o activado.

El valor especificado sustituye completamente la configuración actual de log y no se fusiona con esta. Las opciones de configuración de log posicional son las siguientes:

  • 1: registrar los mensajes de error en el log del componente de XAPI de ACSLS.

  • 01: registrar los mensajes en el archivo log.

  • 001: registrar los errores de transacción de entradas en el archivo log.

  • 0001: registrar todos los paquetes XML recv() en el archivo log.

  • 00001: registrar todos los paquetes XML send() en el archivo log.

  • 000001: registrar los comandos locales y las respuestas en el archivo log.

Los mensajes de LOG de XAPI se guardarán en el archivo $ACS_HOME/log/xapi/vlog.file.

Nota:

El comando LOG le permite establecer y mostrar más posiciones de ceros y unos (16) que las definidas actualmente como las configuraciones de LOG anteriores. Esto permite una expansión futura, y las configuraciones extrañas de ceros y unos de LOG simplemente se ignoran.
OFF

De manera opcional, especifica que se debe desactivar el registro. Esto es equivalente a LOG 0.

Ejemplo

En el siguiente ejemplo, un usuario ejecuta el comando LOG para configurar el servidor de la XAPI para que registre todos los errores y todos los paquetes de XML recv() en el archivo log:

XCMD LOG 1011

LIST

En la siguiente sección, se describe el comando LIST.

Descripción

El comando LIST muestra la configuración y el estado actuales del servidor de la XAPI.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando LIST:

Figura 4-2 Sintaxis del comando LIST

El texto adyacente describe Figura 4-2 .

Parámetros

Como se muestra en la Figura 4-2, el comando LIST incluye los siguientes parámetros:

ALL

De manera opcional, muestra todos los estados y la configuración del servidor de la XAPI. Este es el parámetro por defecto si se ejecuta el comando LIST sin parámetros.

CB name

Especifica que el bloque de control mencionado se muestra en formato de caracteres y caracteres hexadecimales. Úselo solo cuando el soporte de Oracle se lo indique.

Especifique uno de los siguientes bloques de control para name:

  • HTTPCVT

  • HTTPGBL

  • HTTPREQ-nnn

  • HTTPAPI-nnn

Para LIST CB HTTPREQ y LIST CB HTTPAPI, se debe especificar un índice entre 0 y 999. Además, el índice debe estar delimitado respecto del nombre del bloque de control mediante un guion simple ("-") sin espacios. Por ejemplo:

LIST HTTPREQ-0

o

LIST HTTPAPI-900

FILES

De manera opcional, especifica que se muestre el nombre de ruta completo de los archivos log, de control y de rastreo del servidor de la XAPI.

HISTORY

De manera opcional, especifica que se muestre el historial de recuento de transacciones de XAPI para las últimas 24 horas.

LOG

De manera opcional, especifica que se muestre la configuración de log actual del servidor de la XAPI. Esto es equivalente a ejecutar un comando LOG sin parámetros.

MSGLVL

De manera opcional, especifica que se muestre la configuración de nivel de mensaje actual del servidor de la XAPI. Esto es equivalente a ejecutar un comando MSGLVL sin parámetros.

SERVER

De manera opcional, especifica que se muestren las versiones actuales de UNIX y del servidor de la XAPI, los parámetros relevantes y las variables de entorno, además de las colas de mensajes y los segmentos compartidos.

También puede incluir la palabra clave PROCESS para solicitar que se muestren todos los ID de los procesos activos del servidor de la XAPI, los recuentos de archivos abiertos y threads, y el uso de memoria y CPU.

PROCESS

Cuando se especifica con SERVER, la palabra clave PROCESS solicita que también se muestren todos los ID de los procesos activos del servidor de la XAPI, los recuentos de archivos abiertos y threads, y el uso de memoria y CPU.

TASKS

De manera opcional, especifica que se muestren las tareas actuales de trabajo y del sistema del servidor de la XAPI.

TRACE

De manera opcional, especifica que se muestre la configuración de rastreo actual del servidor de la XAPI. Esto es equivalente a ejecutar un comando TRACE sin parámetros.

XAPI

De manera opcional, especifica que se muestren el puerto del listener y la dirección IP actuales del servidor de la XAPI.

Además, puede incluir la palabra clave IO para solicitar que también se muestren todas las estadísticas del listener del servidor de la XAPI.

Ejemplo

En el siguiente ejemplo, un usuario ejecuta el comando LIst para mostrar el puerto del listener, la dirección IP y el estado de listener actuales del servidor de la XAPI:

XCMD LIST XAPI IO

MSGLVL

En la siguiente sección, se describe el comando MSGLVL.

Descripción

El comando MSGLVL cambia o muestra el nivel de detalle del mensaje del servidor de la XAPI.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando MSGLVL:

Figura 4-3 Sintaxis del comando MSGLVL

El texto adyacente describe Figura 4-3 .

Parámetros

Como se muestra en Figura 4-3, el comando MSGLVL incluye los siguientes parámetros:

LIst

Especifica que se muestre la configuración de MSGLVL actual. Si no se especifican parámetros de comando, el valor por defecto es LIst.

level

Especifica la configuración de MSGLVL deseada. Cuanto mayor sea el nivel, más detallados serán los mensajes del servidor de la XAPI. Los niveles de mensaje son acumulativos; MSGLVL 8 genera todos los mensajes hasta MSGLVL 8 inclusive (es decir, genera los mensajes de MSGLVL 0 a 8). Los niveles de mensaje se generalizan de la siguiente manera:

  • 0: mensajes de inicio, cierre y error normales; estos mensajes no se pueden suprimir.

  • 4: advertencias graves.

  • 8: advertencias menores.

  • 12: mensajes de opciones y parámetros de inicio.

  • 16: mensajes adicionales de inicio y cierre.

  • 20: mensajes de nivel de diagnóstico 20 adicionales.

  • 24: mensajes de nivel de diagnóstico 24 adicionales.

  • 28: mensajes adicionales de inicio y cierre de tarea.

OFF

Especifica que se deben desactivar todos los mensajes detallados. Esto es equivalente a MSGLVL 0.

Ejemplo

En el siguiente ejemplo, un usuario ejecuta el comando MSGLVL para cambiar los mensajes del servidor de la XAPI para incluir todas las advertencias:

XCMD MSGLVL 8

TRACE

En la siguiente sección, se describe el comando TRACE.

Descripción

El comando TRACE cambia o muestra la configuración de rastreo del servidor de la XAPI.

Nota:

  • Las variables de entorno de ACSLS establecen el nombre y la ubicación del archivo de rastreo, cuyos valores por defecto son el nombre de archivo vtrace.file y la variable DV_TAG_XAPI_WORK_PATH.

  • El rastreo puede afectar de manera significativa al rendimiento del sistema. Solo active el rastreo si se lo solicita el soporte de Oracle StorageTek.

  • El comando TRACE le permite establecer y mostrar más posiciones de ceros y unos (16) que las definidas actualmente como las configuraciones de TRACE anteriores. Esto permite una expansión futura, y las configuraciones extrañas de ceros y unos de TRACE simplemente se ignoran.

Sintaxis

En la siguiente figura, se muestra la sintaxis del comando TRACE:

Figura 4-4 Sintaxis del comando TRACE

El texto adyacente describe Figura 4-4 .

Parámetros

Como se muestra en la Figura 4-4, el comando TRACE incluye los siguientes parámetros:

LIst

De manera opcional, especifica que se muestre la configuración de rastreo actual. Si no se especifican parámetros de comando, el valor por defecto es LIst.

trace_setting

De manera opcional, indica la configuración de rastreo deseada como una serie de caracteres "0" y "1". 0 significa que la configuración de rastreo posicional deseada debe ser OFF o desactivado, mientras que 1 significa que la configuración de rastreo posicional deseada debe ser ON o activado. El valor especificado sustituye completamente la configuración actual de rastreo y no se fusiona con esta. Las opciones de configuración de rastreo posicional son las siguientes:

  • 1: rastrea errores y los registra en el archivo de rastreo.

  • 01: rastrea eventos y funciones TCP/IP y los registra en el archivo de rastreo.

  • 001: rastrea eventos y funciones PGMI o ACSAPI y los registra en el archivo de rastreo.

  • 0001: rastrea eventos del servidor de la XAPI no clasificados de otro modo y los registra en el archivo de rastreo.

  • 00001: rastrea eventos malloc() y free() y los registra en el archivo de rastreo.

  • 000001: rastrea eventos del analizador XML y los registra en el archivo de rastreo.

  • 0000001: rastrea eventos de procesos del servidor de comandos y los registra en el archivo de rastreo.

  • 00000001: rastrea eventos del proceso de supervisión y los registra en el archivo de rastreo.

  • 000000001: rastrea eventos y funciones CSV y los registra en el archivo de rastreo.

OFF

De manera opcional, especifica que el rastreo está desactivado. Esto es equivalente a TRACE 0.

Ejemplo

En el siguiente ejemplo, un usuario ejecuta el comando TRACE para configurar el servidor de la XAPI con el fin de que rastree todos los errores y todos los eventos malloc() y free() y los registre en el archivo de rastreo:

XCMD TRACE 10001