Propiedades de enlace

El archivo de propiedades de enlace indica al servlet de pasarela dónde encontrar las transacciones Web y cómo comunicarse con ellas. La función suministrada por el archivo es similar a la suministrada por la tabla de enlace en los programas cliente/servidor de VisualAge Generator. Este archivo se especifica mediante el parámetro hptLinkageProperties en los parámetros del servlet de pasarela. Por omisión, las propiedades de enlace se almacenan en el archivo gw.properties de la carpeta JavaResources\JavaSource.

El archivo de propiedades de enlace contiene tres tipos de entradas: application, serverLinkage y options. Cada entrada de aplicación identifica una o varias transacciones Web y está relacionado con entradas serverLinkage que indican cómo conectarse a dichas transacciones Web.

A continuación figura un ejemplo de un archivo de propiedades de enlace:
application.WEBUITRAN=CICS5 
application.WEBUI*=CICS5 
application.STF*=idaho
application.MATT*=IMSC 
application.BASIC*=rtpas400 
application.Z*=remoteC

serverLinkage.CICS5.commtype=CICSECI 
serverLinkage.CICS5.contable=CSOE037
serverLinkage.CICS5.location=nracics5 
serverLinkage.CICS5.serverid=CPMI 
serverLinkage.CICS5.javaProperty=my.pkg

serverLinkage.idaho.commtype=TCPIP 
serverLinkage.idaho.contable=CSOX437 
serverLinkage.idaho.location=machine01
serverLinkage.idaho.serverid=9877 
serverLinkage.idaho.javaProperty=my.pak

serverLinkage.IMSC.commtype=TCPIMS 
serverLinkage.IMSC.contable=CSOE037 
serverLinkage.IMSC.location=carimsc
serverLinkage.IMSC.tcpport=4000 
serverLinkage.IMSC.javaProperty=my.pak 
serverLinkage.IMSC.imsgroupid=mygroup
serverLinkage.IMSC.imsdestid=IMSC  
serverLinkage.IMSC.serverid=*  

serverLinkage.rtpas400.commtype=as400
serverLinkage.rtpas400.contable=CSOE037 
serverLinkage.rtpas400.location=rtpas400
serverLinkage.rtpas400.javaProperty=my.pag 
serverLinkage.rtpas400.library=sdearth

serverLinkage.remoteC.commtype=cicseci 
serverLinkage.remoteC.contable=CSOI1252
serverLinkage.remoteC.location=CSONT2 
serverLinkage.remoteC.serverid=CPMI
serverLinkage.remoteC.ctgLocation=ctghostname 
serverLinkage.remoteC.ctgPort=2006
serverLinkage.remoteC.javaProperty=my.cicspkg

Entradas application

Las entradas de tipo application tienen el siguiente formato:
application.tranweb=nombreservidor
tranweb
El nombre de la transacción Web.

El carácter final puede ser el carácter de comodín (*). La entrada application.webui*=CICS5, por ejemplo, se utiliza para todas las transacciones Web que empiezan por los caracteres webui.

Si varias entradas de tipo application coinciden con el nombre de una transacción Web, la entrada más específica tiene preferencia. Por ejemplo, un servlet de pasarela intenta acceder a la transacción Web webuitran cuando el archivo de propiedades de enlace contiene las siguientes entradas:
application.webui*=abc application.webuit*=def
En este caso, se utiliza la segunda sentencia.
nombreservidor
Nombre arbitrario asignado a una entrada de tipo application y a un conjunto relacionado de entradas serverLinkage para una transacción Web determinada. Observe la siguiente entrada application, por ejemplo:
application.SERVER1=CICS5

Para acceder a una transacción Web denominada SERVER1, el servlet de pasarela hace referencia a las entradas de serverLinkage identificadas por CICS5.

Entradas ServerLinkage

Las entradas de tipo serverLinkage tienen el siguiente formato:
serverLinkage.nombreservidor.parámetro=valor
nombreservidor
El nombre de la transacción Web.

Nombre arbitrario asignado a un conjunto de entradas de tipo serverLinkage para una transacción Web determinada. El nombre debe estar presente en una entrada de tipo application.

parámetro
Uno de los siguientes:
commtype
Especifica el tipo de comunicaciones utilizado para acceder a la transacción Web. Los valores válidos son los siguientes:
AS400
Se utiliza cuando la transacción Web reside en OS/400.
CICSECI
Se utiliza cuando la transacción Web reside en CICS (CICS para AIX, CICS para MVS, CICS para Solaris o CICS para VSE.)
DIRECT
Se utiliza cuando la transacción Web es un programa Java los niveles 2 y 3 son la misma máquina Windows 2000 o Windows NT y desea que la transacción Web se ejecute en una hebra de la máquina virtual Java Java en la que se ejecuta el servlet de pasarela.
TCPIMS
Se utiliza cuando la transacción Web reside en un sistema IMS.
TCPIP
Se utiliza cuando la transacción Web reside en un sistema Windows 2000, Windows NT, OS/2, AIX, HP-UX o Solaris. Si los entornos de nivel 2 y nivel 3 son la misma máquina Windows 2000 o Windows NT, considere la posibilidad de utilizar commtype DIRECT en lugar de TCPIP.
contable
Especifica la tabla de conversión utilizada en la plataforma de nivel 2. El formato es el siguiente:
CSOzxxxx;
z
Uno de los siguientes formatos binarios, que hacen referencia a la plataforma de nivel 3:
  • I (para Intel)
  • E (para EBCDIC)
  • J (para Java Unicode)
  • X (para UNIX)
xxxx
La página de códigos utilizada para la conversión.

Las rutinas de conversión de SUN Java convierten los datos de acuerdo con las definiciones de datos del registro de UI. Para obtener más información acerca de las tablas de conversión de los diversos lenguajes y plataformas, consulte la Guía de comunicaciones cliente/servidor de VisualAge Generator.

ctgLocation
Opcional. Especifica la máquina en la que reside la Pasarela de transacción CICS. Si no especifica ctgLocation y ctgPort cuando commtype=CICSECI, se presupone que la Pasarela de transacción CICS es local.
ctgPort
Opcional. Especifica el puerto en el que la Pasarela de transacción CICS está a la escucha. Si no especifica ctgLocation y ctgPort cuando commtype=CICSECI, se presupone que la Pasarela de transacción CICS es local.
Nota: El procedimiento para establecer el número de puerto del escucha de Pasarela de transacción CICS depende de la versión de ese producto: para la versión 3.01, utilice el mandato ctgStart -port; para la versión 3.03, utilice el mandato JGate -port; para otras versiones, consulte el manual de configuración de la Pasarela de transacción CICS. El número de puerto por omisión es 2006.
location
Para commtype=CICSECI, especifica el identificador del sistema CICS que corresponde al nombre de servidor del archivo CICSCLI.INI del cliente CICS. Para commtype=TCPIMS, commtype=TCPIP o commtype=AS400, especifica el nombre de sistema principal TCP/IP de la máquina en la que reside la transacción Web.
remoteapptype
Si la transacción Web es un programa Java y commtype=TCPIP, especifique el valor VGJAVA; de lo contrario, no incluya este parámetro.
serverid
Para commtype=CICSECI, especifica el ID de transacción CICS del capturador. En la mayoría de los casos, se cumple lo siguiente:
  • El valor de serverid es CPMI, lo que provoca la invocación al programa DFHMIRS.
  • Si especifica un ID de transacción que no es CPMI, CICS inicia CPMI, pasando el control a la transacción CICS especificada, que a su vez pasa el control al programa DFHMIRS.

Para evitar iniciar CPMI cuando el ID de transacción no es CPMI, añada tpn_ al principio del ID de transacción. Por ejemplo, si el ID de transacción es WEBT, especifique tpn_WEBT, pero si el ID de transacción es CPMI, especifique solo CPMI. Si especifica WEBT sin tpn_, CICS inicia CPMI, que a su vez pasa el control a WEBT.

Nota: En relación a OS/390, serverid se pasa por alto y la transacción CICS siempre se ejecuta como CPMI a menos que:
  • CICS TS V1.3 se haya instalado con el PTF UQ47399.
  • La versión de la Pasarela de transacción CICS sea V3.1.2 o anterior.

En commtype=TCPIP, serverid especifica el número de puerto del socket que está a la escucha en la máquina en la que reside la transacción Web.

En commtype=TCPIMS, serverid especifica el código de transacción IMS. Si establece serverid=*, el valor de nombreservidor se utiliza como código de transacción.

En commtype=AS/400, serverid no se utiliza.

tcpport
En commtype=TCPIMS, especifica el número de puerto del socket que está a la escucha en la máquina en la que reside la transacción Web. El socket de escucha está configurado en la conexión IMS TCPIP Open Transaction Manager Access (ITOC).
javaProperty
Especifica el paquete Java en el que se encuentran el objeto de registro de UI y el bean de registro de UI de la transacción Web. Esta entrada es sensible a mayúsculas y minúsculas.
imsgroupid
Especifica un grupo RACF al que el usuario debe conectarse para la autenticación. Esta entrada sólo es válida para conexiones TCPIMS.
imsdestid
Especifica el sistema IMS en el que se ejecuta la transacción Web, según lo haya definido la configuración ITOC. Esta entrada sólo es válida para conexiones TCPIMS.
library
Especifica el nombre de la biblioteca del sistema OS/400 en la que reside la transacción Web. Si la plataforma de nivel 3 es OS/400 y omite esta entrada o la deja en blanco, VisualAge Generator busca la transacción Web en la biblioteca QVGEN, y luego en la lista de bibliotecas especificada por la variable de OS/400 QUSRLIBL.
valor
El valor en el que se establece el parámetro.

Entradas de tipo options

Son válidas las siguientes entradas de tipo options:
  • hptGateway.propertiesRefreshInterval=n
    n
    Especifica el número de minutos que transcurren entre las inspecciones del servlet de pasarela del archivo de propiedades de enlace.

    Esta entrada permite poner dinámicamente en vigor los cambios efectuados en el archivo de propiedades de enlace, sin que sea necesario detener e iniciar el servidor de aplicaciones Web. Las transacciones Web iniciadas después de la inspección se invocan con los valores nuevos. El valor 0 indica que el servlet de pasarela revisa el archivo de propiedades de enlace sólo durante el inicio.

  • application.tranweb.traceFlag=n
    tranweb
    El nombre de la transacción Web, el mismo que el del parámetro del mismo nombre de las entradas de tipo application.
    n
    Indica si el servlet de pasarela debe suministrar rastreo interno a nivel de comunicaciones, que resulta de utilidad sólo si está en contacto con el soporte técnico de IBM. Las alternativas son 1 (para rastreo) o 0 (para ninguno, el valor por omisión). El rastreo a nivel de comunicaciones requiere la presencia del parámetro del servlet de pasarela hptErrorLog, que generalmente se encuentra en el archivo de propiedades de pasarela.

Tareas relacionadas
Configurar un proyecto para ejecutar transacciones Web
Añadir soporte para transacciones Web a un proyecto Web EGL

Consulta relacionada
Parámetros del servlet de pasarela

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.