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