Traza para el soporte

Gestión de pantalla

Pestaña Pantalla de entrada

Tarea batch

Esta función puede lanzarse en Batch, pero no existe ninguna tarea estándar dedicada a su lanzamiento.

Mensajes de error

No hay ningún mensaje de error aparte de los mensajes de error genéricos.

Tablas utilizadas

Consulta la documentación de Puesta en marcha

Información de la traza

El fichero de traza es un fichero en formato XML (Extensible Markup Language).

El fichero XML contiene una etiqueta <LOGFILE VERSION='n'>. Los detalles de la traza se indican en etiquetas individuales agrupadas en la etiqueta <LOGFILE VERSION='n'>. Las etiquetas individuales son las siguientes:

• <INFOS>. El contenido de esta etiqueta proporciona información general, como la fecha en la que se ha generado la traza.
• <CLIENT>. El contenido de esta etiqueta proporciona información sobre el cliente (si la traza se ha generado desde el cliente-servidor).
• <CONF_FILE NAME='FOLDERS.xml'>. El contenido de esta etiqueta resume la configuración de los dossieres en el fichero FOLDERS.xml.
• <CONF_FILE NAME='solution.xml'>. El contenido de esta etiqueta resume la configuración de la solución en el fichero solution.xml.
• <DATABASE>. El contenido de esta etiqueta proporciona las características de la base de datos en curso.
• <WEBSERVERCONF>. El contenido de esta etiqueta proporciona información sobre los servidores web disponibles en la solución.
• <EDTSERVERCONF>. El contenido de esta etiqueta proporciona información sobre los servidores de impresión disponibles en la solución.
• <FOLDER CODE='FOLDER'>. Esta etiqueta se incluye en cada dossier. El contenido de esta etiqueta describe las características del dossier "FOLDER" (FOLDER = nombre del dossier). Se muestran todos los dossieres, pero solo se proporcionan las características del dossier de lanzamiento (todos los datos), del dossier principal del dossier en curso si es diferente (datos seleccionados), y del dossier raíz ("X3") de la solución (datos seleccionados).

Las siguientes subsecciones describen el contenido de cada etiqueta.

Contenido de la sección INFOS

El contenido entre las etiquetas <INFOS> y </INFOS> es el siguiente:

• <DATE>. Fecha y hora iniciales de la función.
• <FOLD>. Dossier desde el que se lanza la función.
• <USER>. Código del usuario que ha lanzado la función.
• <RUNTIME>. Versión del cliente y número de licencia, definido por ver$(0).
• <SOFTWARE_VERSION>. Número de versión de la aplicación (por ejemplo, 11.0.12).
• <PATCHLIST>. Último parche realizado.
• <PATCHDATE>. Fecha del último parche realizado.
• <INCIDENT_ID>. Número de incidente introducido en el lanzamiento de la función. En principio, el número de incidente lo proporciona el servicio de soporte.

Contenido de la sección CLIENT

El contenido entre las etiquetas <CLIENT> y </CLIENT> es el siguiente:

• <X3VERSION>. Número de versión de la aplicación correspondiente al cliente (por ejemplo, 001.12.2019).
• <X3FILEVERSION>. Número de versión técnica (por ejemplo, 15c.06).
• <X3CLTVERSION>. Número de versión complementaria (solo para el cliente 107).

Contenido de la sección FOLDERS.xml

El contenido entre las etiquetas <CONF_FILE NAME='FOLDERS.xml'> y </CONF_FILE> corresponde al contenido del fichero FOLDERS.xml:

• Etiqueta <INFOFOLDERS versolsup='version'>.
  El contenido de esta etiqueta proporciona información sobre la solución:
• <ACTUAL>. Lista de dossieres (una sección <FOLDER> por dossier).
• <DEFLIC>. Definición de la licencia (número, fecha de caducidad, textos partner/client, número de sesiones, opciones).

Contenido de la sección solution.xml

El contenido entre las etiquetas <CONF_FILE NAME='solution.xml'> y </CONF_FILE> corresponde al contenido del fichero solution.xml:

• Una etiqueta <solution name='name' mainport='port_number'> proporciona información sobre los componentes técnicos de la solución (name') definida en el puerto IP ('port_number'):
• <module name='name' family='APPLICATION' type='X3'>. Información sobre el servidor de aplicación.
• <module name='name' family='RUNTIME' type='MAIN'>. Información sobre el runtime.
• <module name='name' family='DOC' type='X3'>. Información sobre el servidor de documentación.
• <module name='name' family='WEB' type=''>. Información sobre el servidor web.
• <module name='BOXIRn' family='BUSOBJ' type=''>. Información sobre el servidor de Business Objects, donde "n" es el número de versión de Business Objects (por ejemplo, "BOXIR3").
• <module name='name' family='REPORT' type=''>. Información sobre el servidor de impresión.
• <module name='name' family='DATABASE' type='database'>. Información sobre el servidor de base de datos, donde "type" es la base de datos (por ejemplo, "ORACLE").
• <module name='SAGE_SEARCH' family='EXALEAD' type='MASTER'>. Información sobre el servidor de búsqueda.
• <module name='name' family='SERVERJAVA' type=''>. Información sobre el servidor Java.

Contenido de la etiqueta DATABASE

El contenido entre las etiquetas <DATABASE TYPE='database_type'> y </DATABASE> es el siguiente:

• <NAME>. Nombre de la base de datos.
• <VERSION>. Número de versión.
• <VERSION_DESC>. Descripción detallada de la base de datos y del número de versión.

Contenido de la sección WEBSERVERCONF

Las etiquetas <WEBSERVERCONF> y </WEBSERVERCONF> contienen una etiqueta <WEBSERVER_ID name='name'> por servidor web disponible. Las etiquetas que describen cada servidor web proceden del fichero config.ini. La información se proporciona de la siguiente manera:

• Las etiquetas <SERVER_NAME> y <SERVER_PATH> indican la ubicación de los ficheros de configuración.
• La jerarquía del fichero config.ini describe detalladamente la configuración web:
  
  <ALL>
  <APACHE>
  <APACHEDOCS/>
  <APACHEPORT/>
  ...
  </APACHE>
  <CONTROL>
  <DOCONFIG/>
  <EMBEDEDSOFTS/>
  ...
  </CONTROL>
  <CONTROL>
  ...

El número de secciones y subsecciones es importante. Estos detalles no se proporcionan aquí. La interpretación de los valores es responsabilidad del equipo de desarrollo.

Si, por algún motivo, no se encuentra el fichero de configuración web, puede mostrarse una sección <STATUS> en lugar de los detalles del fichero de configuración. Si no se puede acceder al valor de esta etiqueta, no se ha encontrado el fichero de configuración.

Contenido de la sección EDTSERVERCONF

Las etiquetas <EDTSERVERCONF> y </EDTSERVERCONF> contienen una etiqueta <EDTSERVER_ID name='name'> por servidor de impresión publicado disponible. Las etiquetas que describen cada servidor de impresión proceden del fichero adxeditionserverconfig.ini, que se encuentra en los directorios del servidor de impresión. La información se proporciona de la siguiente manera:

<AdxSrvImp>
<cap config='' id=''>
<general adxsolprf='' lang='' log='' port='' restartrpts='' />
<log number='' size="''" />
<jobs max='' purgetime='' vpalloc='' />
<processes killtime='' max='' min='' />
</config>
</AdxSrvImp>

La interpretación de los valores es responsabilidad del equipo de desarrollo.

Si, por algún motivo, no se encuentra el fichero de configuración del servidor de impresión, puede mostrarse una sección <STATUS> en lugar de los detalles del fichero de configuración.

• Si no se puede acceder al valor de esta etiqueta, no se puede encontrar el fichero de configuración.
• Si no se puede acceder al valor de esta etiqueta, no se ha encontrado el servidor de impresión (no se obtiene respuesta en la solicitud de conexión).

Este error se puede producir si el procesamiento de escaneado se conecta al puerto de administración 1818. Es el puerto que se utiliza por defecto en las instalaciones del software. Si no se utiliza este puerto, hay que redefinirlo creando una variable global denominada GADMINPORT de tipo "Integer". De esta forma, se obtendrá el valor adecuado.

Contenido de la sección FOLDER

El contenido entre las etiquetas <FOLDER CODE='folder_code'> y </FOLDER> es el siguiente:

Una sección diferente por dossier.

• <HEADER>. Información sobre las características generales del dossier 'folder_code'. La cabecera incluye las siguientes etiquetas:
• <NAME>. Nombre del dossier.
• <REFFOLDER>. Nombre del dossier de referencia.
• <TESFOLDER>. Indicador de los dossieres de prueba.
• <SPEFOLDER>. Indicador de los dossieres específicos.
• <DATABASE>. Nombre de la base de datos.
• <LANGUAGE>. Lista de idiomas definidos en el dossier.
• <DEFLANGUAGE>. Idioma por defecto.
• <MODULES>. Lista de módulos activos.
• <STARTDATE>. Fecha inicial.
• <RPTCURRENCY>. Divisa de reporting.
• <DEFCOUNTRY>. Código de país por defecto.
• Información del fichero APL.ini. Esta información se define en una etiqueta <APL_INI>, en la que cada variable contiene su propia etiqueta cuyo nombre es el nombre de la variable en mayúsculas. Cuando la variable se dimensiona, los paréntesis se reemplazan por un guion bajo ("_"). Puede incluir, por ejemplo, las siguientes etiquetas: <ADXMOTHER_0_0>, <ADXMOTHER_1_0>, <ADXMSO>, <ADXMTO>, <ADXMPR>, <ADXMUA>, <MAXMEM>, <SADMEM>, <ADXTCT>, <ADXTLK>, <ADXTMS>, <MAXHEAP>.

• <ACTIVITY_CODES>. Los valores de los códigos de actividad. Esta sección contiene tres subsecciones: <FUNCTIONAL>; <SIZING>; <LOCALIZATION>.
  En cada subsección, hay una subsección adicional por módulo denominada <MODULE NAME='module_name'> que contiene los siguientes datos:
• Una sección <ACTIVITY_CODE CODE='activity_code'> cuyas subsecciones <ACTIVE> tienen asignado el valor "Sí" o "No"; <DIMENSION>; <DIM_MIN>; <DIM_MAX> para los códigos de tipo <SIZING> (dimensionamiento).

• <ENTRY_POINTS>. Los puntos de entrada y, en cada uno de ellos, una subetiqueta <STD_TRT NAME='standard_entry point_name'> con las secciones <SPE_TRT> y <ACV_CODE>.

• <CPYLIST>. La lista de sociedades y, en cada sociedad, una subetiqueta <COMPANY CODE='company code'> que contiene los siguientes datos:
• <NAME>.
• <LEGISLATION>.
• <SITLIST>. La lista de plantas y, en cada planta, una subetiqueta <SITE NAME='code'> que contiene el código de la planta financiera asociada en una sección <FINANCIAL>.

• <PARAMVALUES>. Los valores de los parámetros. Los grupos de parámetros están delimitados por una etiqueta <PARAMGRP NAME='group_code'> con una subsección <PARAM NAME='parameter_code'> por parámetro. Cada subsección contiene una etiqueta <VALUES> con los siguientes datos:
• <FOLDERVALUE>. El valor del dossier. Si no se indica ningún valor, la etiqueta contiene <LEG NAME='legislation_code'> con los siguientes datos:
• <LEGVALUE>. El valor indicado en la legislación, si existe (opcional). Incluye los valores de los parámetros definidos por excepción en los niveles inferiores (sociedades vinculadas a la legislación, plantas que dependen de dichas sociedades).
• <CPY name='company_code'>. Definido si hay un valor de parámetro a nivel de la sociedad, o al menos una de las plantas asociadas a la sociedad. Esta etiqueta contiene las siguientes subsecciones:
• <CPYVALUE>. Valor vinculado a la sociedad, si existe.
• <FCY NAME='site_code'> que contiene una etiqueta <FCYVALUE> si el parámetro está definido a nivel de la planta.

• <USER_VALUES>. Los valores de los parámetros asociados a los usuarios, si existen. Los valores se encuentran en una subetiqueta <USER CODE='user_code'> que contiene los siguientes valores:
• <LOCALPRG>. Lista de procesos que no corresponden a ningún tipo específico, cuyo fichero ejecutable se encuentra en el dossier de referencia (y no en el dossier de prueba o de desarrollo).
• <SPEPRG>. Lista de scripts que corresponden a un tipo específico de script.
  
• <PATCHES>. Lista de parches instalados en el dossier, por tipo. Cada tipo constituye un grupo <TYPE CODE='code_type'> que contiene una subetiqueta <CURRENT_STATUS> que, a su vez, contiene un grupo por versión. Cada grupo contiene los siguientes datos:
• <VERSION ID='version_number'>. Número de versión. Esta sección contiene los siguientes datos:
• <FIRST NUM='number'>. Primer número de parche realizado (con los datos <COMMENT>, <FILE>, <PATCHNUM>).
• <LAST NUM='number'>. Último número de parche realizado (con los datos <COMMENT>, <FILE>, <PATCHNUM>).
• <MISSING NUM='number'>. Número del parche que falta, o integer en formato first_number - last_number. Esta etiqueta solo aparece si faltan elementos en la numeración.
• <INSTALL_HISTORY>. En cada tipo de parche (etiqueta <TYPE CODE='code'>) y en cada versión mayor (etiqueta <VERSION ID='xxx'>), se proporciona una lista de etiquetas <PATCHLIST num='number' date='date of installation'> con las siguientes etiquetas:
• <USER>. Código del usuario que ha instalado la lista.
• <COMMENT>. Comentario asociado al primer parche de la lista.
• <FILE>. Nombre del fichero correspondiente.
• <MAINTENANCE>. Número de mantenimiento.
  Nota: Si se ha realizado varias veces una misma lista de parches, aparece en varias ocasiones en el histórico (se distinguen por el primer número de parche).
• <DATABASE TYPE='database_type'>. Tipo de base de datos. Esta etiqueta contiene varias secciones:
• <STATS>. Es la primera sección. En cada tabla, contiene la subsección <TABLE NAME='table_name'> con los siguientes datos:
• <LAST_ANALYSIS>. Fecha en la que se ha realizado el último escaneado de los índices.
• <NB_ROWS>. Número líneas de la tabla.
• <INDEXES_VERIFICATION>. Es la segunda sección. Constituye otra función. De esta forma, los resultados del análisis de los índices se muestran en las subsecciones individuales:
• <INDEXES_MISSING>. Los índices que faltan (con una sección <INDEX TABLE='table'> en cada índice que contiene los campos <NAME> y <INDEX>).
• <INDEXES_MISSING_ON_INACTIVE_TABLES>. Los índices que faltan en las tablas inactivas (con los mismos datos).
• <OPTIMIZATION_INDEX_MISSING>. Los índices de optimización activos que faltan en las tablas (con los mismos datos).
• <OPTIMIZATION_INDEX_INACTIVE_ON_TABLES>. Los índices de optimización de las tablas inactivas (con los mismos datos).
• <INTERNAL_INDEXES>. Los índices internos encontrados.
• <INDEXES_NOT_DESCRIBED_IN_DICTIONARY>. Proporciona la lista de índices que existen en la base, pero que no están descritos en el diccionario.
• <INDEX_NOT_CONFORMANT>. Los índices no conformes.

Comentarios

La información de las secciones delimitadas por la etiqueta <FOLDER CODE='folder_code'> no existe en todos los dossieres:

• La sección <HEADER> siempre se muestra.
• La sección <ACTIVITY_CODES> siempre se muestra.
• La sección <ENTRY_POINTS> siempre se muestra.
• La sección <CPYLIST> siempre se muestra.
• La sección <PARAMVALUES> solo se muestra en los dossieres del dossier Supervisor ("X3" en la aplicación).
• La sección <LOCALPRG> solo se muestra en los dossieres del dossier Supervisor ("X3" en la aplicación).
• La sección <DATABASE> solo se muestra en el dossier desde el que se ha lanzado la utilidad. Por lo tanto, es importante elegir correctamente el dossier en el que se va a lanzar la utilidad.

Contenido de la sección DATABASE