Parámetros del servlet de pasarela

Por omisión, el servlet de pasarela tiene definido sólo un parámetro: el parámetro hptGatewayProperties. Este parámetro especifica un archivo de propiedades de pasarela. El archivo de propiedades de pasarela establece el resto de parámetros del servlet de pasarela. Por omisión, el archivo de propiedades de pasarela es el archivo gw.properties de la carpeta JavaResources\JavaSource. En este archivo, los comentarios empiezan con el símbolo de almohadilla (#).

Como alternativa, puede establecer los parámetros del servlet de pasarela en la misma ubicación en la que se especifica el parámetro hptGatewayProperties. Sin embargo, es mejor establecer los parámetros en el archivo de propiedades de pasarela. Los parámetros del archivo de propiedades de pasarela alteran temporalmente los especificados en el servidor de aplicaciones Web.

Las propiedades de enlace se establecen en el archivo de propiedades de enlace. Este archivo se especifica en el parámetro del servlet de pasarela hptLinkageProperties. Consulte la sección Propiedades de enlace.

Tabla 1. Parámetros del servlet de pasarela
Parámetro del servlet Valor del parámetro Notas
hptDateMask aaaa/dd/mm Obligatorio si hay registros de UI que tengan campos de fecha no numéricos. Para dichos campos, los valores de fecha y hora que pasan entre el nivel 2 y el nivel 3 en cualquier dirección deben corresponder internamente a un formato Gregoriano largo para la fecha y hora. El parámetro hptDateMask especifica dicho formato. Para transacciones Web generadas como programas C++, el formato debe coincidir con el especificado en la variable de entorno EZERGRGL. Para transacciones Web generadas como programas COBOL, el formato de hptDateMask debe coincidir con el formato de fecha y hora especificado durante la instalación del servidor.
hptEntryApp transacción_web Especifica una transacción web que suministra una página de entrada. El nombre del programa debe corresponder a un nombre (por ejemplo, una definición CICS) del entorno de nivel 3. Asimismo, una entrada para el nombre de programa debe estar en el mismo archivo al que el parámetro hptLinkageProperties hace referencia.

Es obligatorio especificar hptEntryPage o hptEntryApp. Si se especifican ambos, se utiliza hptEntryPage.

hptEntryPage /jsp_página_entrada Especifica el JSP de página de entrada, relativo al directorio raíz de documentos.

Es obligatorio especificar hptEntryPage o hptEntryApp. Si se especifican ambos, se utiliza hptEntryPage.

En la salida HTML del JSP de página de entrada, el nombre de la transacción Web invocada por el usuario debe asignarse a hptAppId. Asimismo, el botón SUBMIT que invoca la transacción Web debe tener el nombre hptExec, y el botón SUBMIT que finaliza la sesión del servidor de aplicaciones Web debe tener el nombre hptLogout.

Vagen1EntryPage.jsp se suministra como ejemplo de trabajo. En él, cada nombre de transacción Web se incluye en una cláusula VALUE de una estructura <SELECT>, y la cláusula NAME de esa estructura hace referencia a hptAppId.

hptErrorLog archivo_anotaciones_servlet_pasarela Opcional. Especifica la vía de acceso totalmente calificada de un archivo de anotaciones. Si se especifica este parámetro, el servlet de pasarela suministra un rastreo de eventos y errores, y el usuario puede utilizar las anotaciones para el diagnóstico de problemas. Si se elimina hptErrorLog, se desactiva el rastreo.
hptExpiredPasswordPage /jsp_página_contraseña_caducada Opcional. Especifica el JSP de página de contraseña caducada, relativo al directorio raíz de documentos.

En la salida HTML del JSP de página de contraseña caducada, el campo de entrada de ID de usuario debe tener el nombre hptUserid, el campo de entrada de contraseña antigua debe tener el nombre hptPassword, el campo de entrada de contraseña nueva debe tener el nombre hptNewPassword, el campo de confirmación de entrada de contraseña nueva debe tener el nombre hptConfirmNewPassword y el botón SUBMIT debe tener el nombre hptExpiredPasswordPageLogin.

ExpiredPasswordPage.jsp se suministra como ejemplo de trabajo del JSP.

El parámetro hptExpiredPasswordPage sólo surte efecto si también se ha especificado hptLogonCheck.

hptGatewayProperties archivo_propiedades_pasarela Opcional. Especifica la vía de acceso totalmente calificada de un archivo que contiene los demás parámetros del servlet de pasarela.
hptIDManageHost nombre_sistema_principal Opcional. Especifica el nombre de sistema principal TCP/IP de la máquina en la que se ejecuta el Gestor de ID de sesión. El valor por omisión es localhost.
hptLinkageProperties archivo_propiedades_enlace Obligatorio. Especifica el nombre totalmente calificado del archivo de propiedades de enlace, que establece una conexión entre el servlet de pasarela y cada transacción Web. Consulte la sección Propiedades de enlace.
hptLogonCheck nombre_clase_totalmente_calificado Opcional. Especifica una clase de comprobación de inicio de sesión para manejar la autenticación de usuarios.

RACFValidateLogin se suministra como ejemplo de trabajo. Para utilizar ese ejemplo, especifique lo siguiente:hptLogonCheck=com.ibm.hpt.gateway.RACFValidateLogin

hptLogonPage /jsp_página_inicio_sesión Opcional. Especifica el JSP de página de inicio de sesión, relativo al directorio raíz de documentos. Si este parámetro se omite o si están presentes hptPublicPassword y hptPublicUserid, no se visualiza ninguna página de inicio de sesión.

En la salida HTML del JSP de página de inicio de sesión, el campo de entrada de ID de usuario debe tener el nombre hptUserid, el campo de entrada de contraseña debe tener el nombre hptPassword y el botón SUBMIT debe tener el nombre hptLogin.

Vagen1LogonPage.jsp se suministra como ejemplo de trabajo del JSP.

A continuación figura un ejemplo de un archivo de propiedades de pasarela:
hptLogonPage=/Vagen1LogonPage.jsp
hptEntryPage=/Vagen1EntryPage.jsp
#hptEntryApp=WEBTXN1
hptErrorLog=c:/traces/Vagen1Gateway.log
hptLinkageProperties=c:/linktabs/csogwLinkage.properties
# utilizar la propiedad siguiente si se utiliza Websphere 2.0, 
# que utiliza soporte JSP 0.91 y Servlet 2.0 
#hptServletVersion=2.0

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

Consulta relacionada
Propiedades de enlace

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