Propiedades de ejecución de Java (detalles)

La tabla siguiente describe las propiedades que pueden incluirse en el descriptor de despliegue o en el archivo de propiedades del programa, así como el origen del valor generado en el archivo de entorno J2EE, si lo hay. El tipo Java para cada propiedad es java.lang.String a menos que la columna de descripción indique lo contrario.

Propiedad de tiempo de ejecución Descripción Origen del valor generado
cso.cicsj2c.timeout Especifica el número de milisegundos antes de que se exceda el tiempo de espera durante una llamada que utilice el protocolo CICSJ2C. El valor por omisión es 30000, que representa 30 segundos. Si el valor se establece en 0, no se produce un tiempo de espera excedido. El valor debe ser 0 o mayor.

El tipo Java en este caso es Java.lang.Integer.

La propiedad no tiene efecto alguno sobre las llamadas cuando el código se ejecuta en WebSphere 390; encontrará los detalles en Configuración del servidor J2EE para llamadas CICSJ2C.

Opción del descriptor de construcción cicsj2cTimeout
cso.linkageOptions.LO Especifica el nombre de un archivo de propiedades de enlace que guía la forma en que el programa generado o la envoltura llama a otros programas. LO es el nombre del componente de opciones de enlace utilizado en la generación. Encontrará los detalles en Desplegar un archivo de propiedades de enlace. LO es de la opción del descriptor de construcción linkage y el valor predeterminado es el nombre del componente de opciones de enlace seguido por la extensión .properties
tcpiplistener.port

Especifica el número del puerto en el que está a la escucha un escucha de TCP/IP de EGL (de la clase CSOTcpipListener o CSOTcpipListenerJ2EE). No existe un valor por omisión. Para conocer más detalles, consulte los temas que hace referencia a Configuración de la escucha de TCP/IP.

El tipo Java en este caso es Java.lang.Integer.

No generado
tcpiplistener.trace.file Especifica el nombre del archivo en que se registrará la actividad de uno o varios escuchas de TCP/IP de EGL (todos son de la clase CSOTcpipListener o CSOTcpipListenerJ2EE). El archivo por omisión es tcpiplistener.out. No generado; el rastreo es para uso exclusivo de IBM
tcpiplistener.trace.flag Especifica si debe rastrearse la actividad de uno o varios escuchas de TCP/IP de EGL (todos de la clase CSOTcpipListener o CSOTcpipListenerJ2EE). Seleccione una de estas opciones:
  • 1 para registrar la actividad en el archivo identificado en la propiedad tcpiplistener.trace.flag
  • 0 (el valor por omisión) para no registrar la actividad

El tipo Java en este caso es Java.lang.Integer.

Para conocer más detalles, consulte los temas que hace referencia a Configuración de la escucha de TCP/IP.
No generado; el rastreo es para uso exclusivo de IBM
vgj.datemask. gregorian.long.locale Contiene la máscara de fecha utilizada en cualquiera de dos casos:
  • Se invoca el código Java generado para la variable del sistema VGVar.currentFormattedGregorianDate; o bien
  • EGL valida un campo de formulario de texto o elemento de página que tiene una longitud de 10 o más, si la propiedad de elemento dateFormat está establecida en formatoFechaGregorianoSistema.

locale es el código especificado en la propiedad vgj.nls.code. En las aplicaciones Web, puede cambiar la propiedad de máscara de fecha en uso asignando un valor distinto a sysLib.setLocale.

El valor del descriptor de construcción para la máscara de fecha Gregoriana larga; el valor por omisión es específico del entorno local
vgj.datemask. gregorian.short.locale Contiene la máscara de fecha utilizada cuando EGL valida un elemento de página o un campo de formulario de texto que tiene una longitud de menos de 10, si la propiedad del elemento dateFormat está establecida como formatoFechaGregorianoSistema.

locale es el código especificado en la propiedad vgj.nls.code. En las aplicaciones Web, puede cambiar la propiedad de máscara de fecha en uso asignando un valor distinto a sysLib.setLocale.

El valor del descriptor de construcción para la máscara de fecha Gregoriana corta; el valor por omisión es específico del entorno local
vgj.datemask. julian.long.locale Contiene la máscara de fecha utilizada en cualquiera de dos casos:
  • Se invoca el código Java generado para la variable de sistema VGVar.currentFormattedJulianDate; o bien
  • EGL valida un campo de formulario de texto o elemento de página que tiene una longitud de 10 o más, si la propiedad de elemento dateFormat está establecida en formatoFechaJulianoSistema.

locale es el código especificado en la propiedad vgj.nls.code. En las aplicaciones Web, puede cambiar la propiedad de máscara de fecha en uso asignando un valor distinto a sysLib.setLocale.

El valor del descriptor de construcción para la máscara de fecha Juliana larga; el valor por omisión es específico del entorno local
vgj.datemask. julian.short.locale Contiene la máscara de fecha utilizada cuando EGL valida un elemento de página o un campo de formulario de texto que tiene una longitud de menos de 10, si la propiedad del elemento dateFormat está establecida como formatoFechaJulianoSistema.

locale es el código especificado en la propiedad vgj.nls.code. En las aplicaciones Web, puede cambiar la propiedad de máscara de fecha en uso asignando un valor distinto a sysLib.setLocale.

El valor del descriptor de construcción para la máscara de fecha Juliana corta; el valor por omisión es específico del entorno local
vgj.defaultI4GLNativeLibrary Especifica el nombre de DLL al que accede una biblioteca de tipo nativeLibrary. La propiedad es obligatoria si no ha especificado la propiedad de biblioteca dllName  
vgj.jdbc.database.SN Especifica el nombre de base de datos JDBC que se utiliza cuando se realiza una conexión a base de datos mediante la función del sistema sysLib.connect o VGLib.connectionService.
El significado del valor es distinto para las conexiones J2EE comparado con las conexiones estándar (no J2EE):
  • En relación con las conexiones J2EE (necesario en un entorno de producción), el valor es el nombre al que se enlaza el origen de datos en el registro de JNDI; por ejemplo, jdbc/MyDB
  • En relación con una conexión JDBC estándar (como la que podría utilizarse para depurar), el valor es la URL de conexión; por ejemplo, jdbc:db2:MyDB

Debe personalizar el nombre de la propiedad al especificar un valor de sustitución para SN, en el momento del despliegue. El valor de sustitución debe coincidir a su vez con el nombre de servidor incluido en la invocación de VGLib.connectionService o el nombre de base de datos incluido en la invocación de sysLib.connect.

El valor del descriptor de construcción para el nombre de base de datos que desea asociar con el "nombre de servidor" especificado
vgj.jdbc.default. database.autoCommit Especifica si se produce un compromiso después de cada cambio en la base de datos por omisión. Los valores válidos son true y false, tal como se describe en el apartado sqlCommitControl. Opción de descriptor de construcción sqlCommitControl
vgj.jdbc.default. database.programName Especifica el nombre de base de datos por omisión que se utiliza para una operación de E/S de SQL si no existe una conexión a base de datos previa. EGL incluye el nombre de programa (o alias de programa, si lo hay) como un valor de sustitución para programName de forma que cada programa tenga su propia base de datos por omisión. El nombre de programa es opcional, no obstante, y se utiliza una propiedad denominada vgj.jdbc.default.database como valor por omisión para cualquier programa no referenciado en una propiedad específica de programa de esta clase.

El significado del valor de la propiedad es distinto para las conexiones J2EE en comparación con las conexiones no J2EE:

  • En relación con las conexiones J2EE, el valor es el nombre al que se enlaza el origen de datos en el registro de JNDI; por ejemplo, jdbc/MyDB
  • En relación con una conexión JDBC estándar, el valor es la URL de conexión; por ejemplo, jdbc:db2:MyDB
Dependen del tipo de conexión:
  • Para conexiones J2EE, la opción del descriptor de construcción sqlJNDIName
  • Para conexiones no J2EE, la opción del descriptor de construcción sqlDB
vgj.jdbc.default.password Especifica la contraseña para acceder a la conexión de base de datos identificada en vgj.jdbc.default.database.
Para evitar exponer las contraseñas en el archivo de entorno J2EE, realice una de las siguientes tareas:
  • Especifique una contraseña en scripts de programa y función utilizando la función del sistema sysLib.connect o VGLib.connectionService; o bien
  • Incluya un ID de usuario y contraseña en la especificación de origen de datos en el servidor de aplicaciones web, tal como se describe en Configuración de una conexión JDBC J2EE.
Opción del descriptor de construcción sqlPassword
vgj.jdbc.default.userid Especifica el ID de usuario para acceder a la conexión a base de datos identificada en vgj.jdbc.default.database. Opción del descriptor de construcción sqlID
vgj.jdbc.drivers Especifica la clase de controlador para acceder a la conexión a base de datos identificada en vgj.jdbc.default.database. Esta propiedad no está presente en el descriptor de despliegue o el archivo de entorno J2EE y se utiliza solamente para una conexión JDBC estándar (no J2EE). Opción del descriptor de construcción sqlJDBCDriverClass
vgj.messages.file Especifica un archivo de propiedades que incluye mensajes creados o personalizados. Se busca en el archivo en dos casos:
  • Cuando el tiempo de ejecución de EGL responde a la invocación de la función SysLib.getMessage que devuelve un mensaje creado; para conocer más detalles, consulte el apartado SysLib.getMessage
  • Cuando EGL intenta visualizar un mensaje de tiempo de ejecución Java, tal como se explica en Personalización de mensajes para mensajes de tiempo de ejecución de EGL
 
vgj.nls.code Especifica el código NLS de tres letras del programa. Para obtener una lista de valores válidos, consulte targetNLS.
Si la propiedad no está establecida, se aplican estas normas:
  • El valor toma por omisión el código NLS que corresponde al entorno local de Java por omisión
  • El valor es ENU si el entorno local de Java por omisión no corresponde a ninguno de los códigos NLS soportados por EGL
Opción del descriptor de construcción targetNLS
vgj.nls.currency Especifica el carácter utilizado como símbolo de moneda. El valor por omisión está determinado por el entorno local asociado con vgj.nls.code. Opción del descriptor de construcción currencySymbol
vgj.nls.number.decimal Especifica el carácter utilizado como símbolo decimal. El valor por omisión está determinado por el entorno local asociado con vgj.nls.code. Opción del descriptor de construcción decimalSymbol
vgj.properties.file Sólo se utiliza si el primer programa de una unidad de ejecución no J2EE se generó con VisualAge Generator o con una versión de EGL anterior a 6.0.

vgj.properties.file especifica un archivo de propiedades alternativo. El archivo se utiliza en una unidad de ejecución no J2EE en lugar de cualquier archivo de propiedades de programa no global. La utilización del archivo global no se ve afectada. (En unidades de ejecución cuyo primer programa se generó con el EGL antiguo o con VisualAge Generator, el archivo global se llama vgj.properties.)

El archivo al que hace referencia la propiedad vgj.properties.file solo se utiliza si incluye esa propiedad en una directiva de línea de mandatos, como en este ejemplo:

java -Dvgj.properties.file=c:\new.properties

El valor de vgj.properties.file incluye la vía de acceso totalmente calificada al archivo de propiedades.

El hecho de especificar la propiedad vgj.properties.file en un archivo de propiedades no surte efecto.

 
vgj.ra.QN.conversionTable Especifica el nombre de la tabla de conversión utilizada por un programa Java generado durante el acceso de la cola de mensajes MQSeries identificada por QN. Los valores válidos son programControlled, NONE, o un nombre de tabla de conversión. El valor por omisión es NONE. Propiedad de asociaciones de recurso conversionTable
vgj.ra.FN.fileType Especifica el tipo de archivo asociado con FN, que es un archivo o nombre de cola identificado en el componente de registro. El valor de la propiedad es seqws o mq, tal como se describe en Referencia cruzada de tipos de registro y archivo.

Debe especificar esta propiedad del descriptor de despliegue para cada archivo lógico que utilice el programa.

Propiedad de asociaciones de recurso fileType
vgj.ra.FN.replace Especifica el efecto de una sentencia add en un registro asociado con FN, que es un nombre de archivo identificado en un registro. Seleccione uno de dos valores:
  • 1 si la sentencia sustituye al registro de archivo
  • 0 (el valor por omisión) si la sentencia añade un registro al archivo

El tipo Java en este caso es java.lang.Integer.

Propiedad de asociaciones de recurso replace
vgj.ra.FN.systemName Especifica el nombre del archivo físico o cola de mensajes asociado con FN, que es un archivo o nombre de cola identificado en el componente de registro.

Debe especificar esta propiedad del descriptor de despliegue para cada archivo lógico que utilice el programa.

Propiedad de asociaciones de recurso systemName
vgj.ra.FN.text Especifica si debe provocarse que un programa Java generado haga lo siguiente al acceder a un archivo por medio de un registro serie:
  • Añadir caracteres de fin de la línea durante la operación añadir. En plataformas no UNIX, esos caracteres son los de retorno de carro y salto de línea; en plataformas UNIX, el único carácter es es salto de línea.
  • Eliminar caracteres de fin de la línea durante la operación obtener siguiente.

FN es el nombre de archivo asociado con el registro de serie.

Seleccione uno de estos valores:
  • 1 para realizar los cambios
  • 0 (el valor por omisión) para no realizar los cambios

El tipo Java en este caso es java.lang.Integer.

Propiedad de asociaciones de recurso text
vgj.trace.device.option Destino de los datos de rastreo, si los hay. Seleccione uno de estos valores:
  • 0 para grabar en System.out
  • 1 para grabar en System.err
  • 2 (el valor por omisión) para grabar en el archivo especificado en vgj.trace.device.spec con esta excepción: para rastreos de E/S de VSAM, grabe en vsam.out

El tipo Java en este caso es java.lang.Integer.

El valor generado, si lo hay, es 2
vgj.trace.device.spec Especifica el nombre del archivo de salida si vgj.trace.device.option está establecido en 2. La excepción es que los rastreos de E/S de VSAM se graban en vsam.out. El valor generado, si lo hay, es vgjtrace.out
vgj.trace.type Especifica el valor de rastreo de ejecución. Sume los valores de interés para obtener el rastreo deseado:
  • -1 para rastrear todo
  • 0 para ningún rastreo (el valor por omisión)
  • 1 para rastreo general, incluidas invocaciones de funciones y sentencias call
  • 2 para funciones del sistema que manejan matemáticas
  • 4 para funciones del sistema que manejas series
  • 16 para datos pasados en una sentencia call
  • 32 para las opciones de enlace utilizadas en una llamada
  • 128 para E/S de jdbc
  • 256 para E/S de archivo
  • 512 para todas las propiedades excepto vgj.jdbc.default.password

El tipo Java en este caso es java.lang.Integer.

El valor generado, si lo hay, es 0

Conceptos relacionados
Propiedades de tiempo de ejecución Java
Componente de biblioteca de tipo nativeLibrary
Archivo de propiedades de enlace

Tareas relacionadas
Desplegar un archivo de propiedades de enlace
Establecer una conexión JDBC J2EE
Configuración del entorno de tiempo de ejecución de J2EE para código generado por EGL
Configuración del servidor J2EE para llamadas CICSJ2C
Configurar el escucha TCP/IP para una aplicación llamada en un módulo de cliente de aplicaciones J2EE
Configurar el escucha TCP/IP para una aplicación no J2EE llamada
Cómo se realiza una conexión JDBC estándar

Consulta relacionada
Elemento callLink
cicsj2cTimeout
decimalSymbol
linkage
Archivo de propiedades de enlace (detalles)
Personalización de mensajes para el tiempo de ejecución de Java EGL
Referencias cruzadas de tipo de registro y tipo de archivo
sqlCommitControl
sqlDB
sqlID
sqlJDBCDriverClass
sqlJNDIName
sqlPassword
sysLib.connect
sysLib.getMessage
sysLib.setLocale
VGLib.connectionService
VGVar.currentFormattedGregorianDate
VGVar.currentFormattedJulianDate
VGVar.currentShortGregorianDate
VGVar.currentShortJulianDate
targetNLS

Condiciones de uso | Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.