Configuración de los distintivos de tiempo de ejecución y formato para Creador de documentos en Apache Tomcat

Puede añadir propiedades denominadas distintivos para especificar determinados parámetros para sus aplicaciones.

Antes de empezar

Revise la lista de distintivos de tiempo de ejecución y formato disponibles para su uso para la aplicación Creador de documentos y a continuación seleccione uno para utilizar a fin de completar esta tarea.
Tabla 1. Distintivos de tiempo de ejecución y formato
Distintivo Valor Tipo Descripción
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd Serie

Ejemplo: -Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd=password

Distintivo de Rational Publishing Engine Contraseña necesaria para realizar la autenticación OAuth-OSLC con el distintivo -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr Serie

Ejemplo: -Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr=user

Distintivo de Rational Publishing Engine Nombre de usuario necesario para realizar la autenticación OAuth-OSLC con el distintivo -Dcom.ibm.rational.rpe.config.oslcServiceProviders.
-Dcom.ibm.rational.rpe.enable_commands true, false

Ejemplo: -Dcom.ibm.rational.rpe.enable_commands=true

Distintivo de Rational Publishing Engine Establezca este distintivo en true para habilitar la ejecución de mandatos previos y mandatos posteriores para la aplicación Creador de documentos.
-Dcom.ibm.rational.rpe.console.limit Número de caracteres

Valor predeterminado: 100000 caracteres

Ejemplo: -Dcom.ibm.rational.rpe.console.limit=90000

Distintivo de Rational Publishing Engine Puede controlar el tamaño de la información de registro que se mantiene en la vista de la consola.
-Dcom.ibm.rational.rpe.doors.data Argumento de datos que se pasará a la línea de mandatos de Rational DOORS

Ejemplo: -Dcom.ibm.rational.rpe.doors.data=36677@localhost

Distintivo de Rational Publishing Engine Puede incluir este distintivo para identificar la base de datos de Rational DOORS para que Rational Publishing Engine no tenga que identificarla. Si se establece este valor, mejora el rendimiento cuando Rational DOORS es estable o la generación de documentos está configurada en un sistema donde no se permite la ejecución del mandato reg.exe. Cuando este distintivo está configurado, altera temporalmente el valor de la propiedad doors_param en una especificación de documento. Puede especificar este distintivo como una variable del sistema o de tiempo de ejecución de Java™. Las variables de tiempo de ejecución de Java tienen prioridad sobre las variables del sistema.

Cuando configure este distintivo, debe establecer la propiedad new_instance en true.

-Dcom.ibm.rational.rpe.doors.flags Opciones de línea de mandatos de Rational DOORS

Ejemplo: -Dcom.ibm.rational.rpe.doors.flags="-addins vía de acceso del archivo"

Distintivo de Rational Publishing Engine Puede especificar opciones de línea de mandatos para Rational DOORS. Puede especificar este distintivo como una variable del sistema o de tiempo de ejecución de Java. Las variables de tiempo de ejecución de Java tienen prioridad sobre las variables del sistema.
-Dcom.ibm.rational.rpe.doors.home Vía de acceso del archivo ejecutable de Rational DOORS
Ejemplo:

-Dcom.ibm.rational.rpe.doors.home=
C:\Program Files (x86)\IBM\Rational\DOORS\9.5\bin\doors.exe

Distintivo de Rational Publishing Engine Puede incluir este distintivo para identificar la versión de Rational DOORS de forma que Rational Publishing Engine no tenga que identificarla. Si se establece este valor, mejora el rendimiento cuando Rational DOORS es estable o la generación de documentos está configurada en una máquina virtual donde no se permite la ejecución del mandato reg.exe. Cuando este distintivo está configurado, altera temporalmente el valor especificado para la propiedad doors_home en una especificación de documento. Puede especificar este distintivo como una variable del sistema o de tiempo de ejecución de Java. Las variables de tiempo de ejecución de Java tienen prioridad sobre las variables del sistema.

Cuando configure este distintivo, debe establecer la propiedad new_instance en true.

-Dcom.ibm.rational.rpe.dxl.enable.memory.management true, false

Valor predeterminado: false

Ejemplo: -Dcom.ibm.rational.rpe.dxl.enable.memory.management=true

Distintivo de Rational Publishing Engine

Cuando un módulo de Rational DOORS está enlazado a otros módulos, Rational Publishing Engine debe abrir estos módulos enlazados en segundo plano cuando se genera un documento. Además, cuando se utiliza código DXL de diseño, los módulos se abren en segundo plano hasta que se completa DXL.

En ambos casos, la memoria del cliente de Rational DOORS se utiliza para abrir y cerrar los módulos en segundo plano. Puede configurar una clave de registro de forma que cuando se alcance un límite de memoria, los procesos en segundo plano se cierren cuando terminen de leer el objeto actual y solo reabran el objeto de nuevo si es necesario.

Cuando -Dcom.ibm.rational.rpe.dxl.enable.memory.management se establece en true, los usuarios pueden establecer una clave de registro para definir este límite de memoria. De lo contrario, se utiliza el límite de memoria predeterminado establecido en el código DXL de 2 GB. Consulte Resolución de problemas de una generación de documentos de Rational DOORS para obtener más información sobre la clave de registro.

El valor predeterminado es false y la clave de registro no tiene ningún efecto en el proceso de generación de documentos.

-Dcom.ibm.rational.rpe.enable.surrogate.char.processing true, false

Valor predeterminado: false

Ejemplo: -Dcom.ibm.rational.rpe.enable.surrogate.char.processing=true

Distintivo de Rational Publishing Engine En la salida de Microsoft Word y PDF, los sustitutos de Unicode, que con frecuencia son caracteres de idiomas asiáticos, se eliminan de la salida. Puede habilitar -Dcom.ibm.rational.rpe.enable.surrogate.char.processing para procesar estos caracteres correctamente durante la generación de documentos de forma que se incluyan en la salida tal como se espera.
-Dcom.ibm.rational.rpe.nonunicodefonts Nombre de font o varios nombres de font no Unicode separados con punto y coma.

Ejemplo: -Dcom.ibm.rational.rpe.nonunicodefonts=Akshar

Distintivo de Rational Publishing Engine Puede especificar fonts para utilizar en Rational Publishing Engine que no son fonts de Unicode. Los fonts no Unicode que especifique deben estar instalados en el mismo sistema en el que se ejecutan las aplicaciones cliente.

Los fonts no unicode no siempre se generan correctamente en la salida de Microsoft Word. Establezca el font en Arial Unicode MS o en cualquier otro font que pueda representar este carácter y la salida se generará correctamente.

-Dcom.ibm.rational.rpe.output.default Directorio temporal

Valor predeterminado: TEMP\rpe\output

Ejemplo: -Dcom.ibm.rational.rpe.output.default=C:\RPE\output

Distintivo de Rational Publishing Engine Puede cambiar el directorio temporal a otra ubicación que no sea la predeterminada. Puede especificar este distintivo como una variable del sistema o de tiempo de ejecución de Java. Las variables de tiempo de ejecución de Java tienen prioridad sobre las variables del sistema.
-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory Un directorio o varios directorios separados con punto y coma.
Ejemplo:

-Dcom.ibm.rational.rpe.pdf.truetypefontdirectory=
C:\Windows\Fonts;d:\fontlib

Distintivo de Rational Publishing Engine Si el sistema tiene fonts adicionales instalados en un directorio distinto al predeterminado, puede especificar estos directorios de fonts.
-Dcom.ibm.rational.rpeng.cookies

Ejemplo: -Dcom.ibm.rational.rpe.cookies=

Distintivo de Rational Publishing Engine Especifique una cookie de clave secreta del Creador de documentos, por ejemplo, rpeng-secret. Puede utilizar la API rpeng/api/secret para obtener la clave secreta cuando se haya iniciado correctamente la sesión.
-Dcom.ibm.rational.rpeng.pwd Contraseña de usuario para la autenticación en el Creador de documentos

Ejemplo: -Dcom.ibm.rational.rpeng.pwd=password

Distintivo de Rational Publishing Engine Para la autenticación en la aplicación Creador de documentos, configure este distintivo con una contraseña.
-Dcom.ibm.rational.rpeng.url Un URL
Ejemplo:

-Dcom.ibm.rational.rpeng.url=
http://servidor:puerto/rpeng/

Distintivo de Rational Publishing Engine URL para conectar a la aplicación Creador de documentos. Es posible que no se pueda editar este URL si el administrador no permite que los usuarios cambien la ubicación.
-Dcom.ibm.rational.rpeng.usr Nombre de usuario para la autenticación en el Creador de documentos

Ejemplo: -Dcom.ibm.rational.rpeng.usr=user

Distintivo de Rational Publishing Engine Para la autenticación en la aplicación Creador de documentos, configure este distintivo con un nombre de usuario.
-Dcom.ibm.rational.rpe.tls12only true, false

Ejemplo: -Dcom.ibm.rational.rpe.tls12only=true

Distintivo de Rational Publishing Engine Cuando se establece en true, Rational Publishing Engine se comunica sólo en modalidad TLS (Transport Layer Security) 1.2. Rational Publishing Engine no comprueba los valores de otras propiedades de máquina virtual Java para identificar el protocolo SSL (Secure Sockets Layer) que se utiliza.
-Dosgi.configuration.area Vía de acceso de archivo
Ejemplo:

-Dosgi.configuration.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Distintivo Java estándar Para cambiar la ubicación de salida predeterminada de las generaciones de documentos, puede cambiar la vía de acceso de archivo para este parámetro. Especifique el mismo valor para los parámetros -Dosgi.instance.area y -Dosgi.configuration.area.
-Dosgi.instance.area Vía de acceso de archivo
Ejemplo:

-Dosgi.instance.area=@user.home/Application
Data/IBM/Rational/RPE_qualifier_date/Launcher/workspace/

Distintivo Java estándar Para cambiar la ubicación de salida predeterminada de las generaciones de documentos, puede cambiar la vía de acceso de archivo para este parámetro. Especifique el mismo valor para los parámetros -Dosgi.configuration.area y -Dosgi.instance.area.
-Duser.country Código de país
Ejemplo para portugués de Brasil:

-Duser.country=BR
-Duser.language=pt

Distintivo Java estándar Establezca este distintivo en una abreviatura de un país correspondiente al código de idioma para establecer el entorno local para las generaciones de documentos. Sólo es necesario incluir -Duser.country cuando hay traducciones disponibles para un idioma específico al que hace referencia cuando se combina con -Duser.language.
-Duser.language Código de idioma

Ejemplo para japonés: -Duser.language=ja

Distintivo Java estándar Establezca este distintivo en una abreviatura de un idioma para establecer el entorno local para las generaciones de documentos. Consulte HTML Language Code Reference para ver más ejemplos de código de idioma.
-Duser.timezone GMT+desplazamiento

Ejemplo: -Duser.timezone=GMT+02:00

Distintivo Java estándar Rational Publishing Engine convierte la fecha y hora en el huso horario del sistema donde está instalado Rational Publishing Engine, no al huso horario del servidor donde se está generando el documento de forma remota. Para especificar que sea la fecha y hora del servidor, especifique GMT y el número de desplazamiento en horas de la ubicación del servidor respecto a la hora media de Greenwich.
–Xmx<valor>m Valor de almacenamiento dinámico de Java

Ejemplo: –Xmx512m

Distintivo de IBM® Java Runtime Environment Disminuya el valor de este parámetro en los archivos de configuración del producto para permitir que Rational Publishing Engine se inicie en máquinas virtuales.

Aumente el valor para mejorar el rendimiento cuando se generen documentos grandes en otros entornos, no máquinas virtuales.

–Xmx es un parámetro Java estándar que no es exclusivo de Rational Publishing Engine.

TELELOGIC_LICENSE_FILE Valor del servidor de licencias que se lista en la variable del sistema TELELOGIC_LICENSE_FILE con la forma port@nombre_host_o_dirección_IP_de_servidor_de_licencias.

Ejemplo: 19353@LicenseServer2

Distintivo de Rational Publishing Engine Variable del sistema que lista la dirección del servidor de licencias.

Procedimiento