ゲートウェイ・サーブレット・パラメーター

デフォルトでは、ゲートウェイ・サーブレットには 1 つのパラメーター、 hptGatewayProperties パラメーターのみが定義されています。 このパラメーターはゲートウェイ・プロパティー・ファイルを指定します。 ゲートウェイ・プロパティー・ファイルは、ゲートウェイ・サーブレットの残りのパラメーターを設定します。 デフォルトでは、ゲートウェイ・プロパティー・ファイルは、 JavaResources¥JavaSource フォルダーの gw.properties ファイルです。 このファイルのコメントは、ポンド記号 (#) で始まります。

もう 1 つの選択肢として、hptGatewayProperties パラメーターを指定する同じ場所に ゲートウェイ・サーブレット・パラメーターを設定することもできます。しかし、 パラメーターは、ゲートウェイ・プロパティー・ファイルに設定する方が一般的です。 ゲートウェイ・プロパティー・ファイルのパラメーターは、Web アプリケーション・サーバーでの指定に優先します。

リンケージ・プロパティーは、リンケージ・プロパティー・ファイルに設定されます。 このファイルは、hptLinkageProperties ゲートウェイ・サーブレット・パラメーターに指定します。 『リンケージ・プロパティー』を参照してください。

表 1. ゲートウェイ・サーブレット・パラメーター
サーブレット・パラメーター パラメーター値 注意
hptDateMask yyyy/dd/mm UI レコードに非数値の日付フィールドがあれば必要です。 これらのフィールドの場合、第 2 層と第 3 層の間でいずれかの方向に渡される 日付/時刻値は内部的には、日時の、長いグレゴリオ暦形式に対応していなければなりません。 hptDateMask パラメーターでその形式を指定します。 C++ プログラムとして生成される Web トランザクションの場合、形式は環境変数 EZERGRGL に指定されているものに一致しなければなりません。 COBOL プログラムとして生成される Web トランザクションの場合、 hptDateMask の形式は、サーバーのインストール時に指定された日付/時刻形式に一致していなければなりません。
hptEntryApp web_transaction エントリー・ページを提供する Web トランザクションを指定します。 プログラム名は、第 3 層環境の名前 (CICS® 定義など) に対応している必要があります。 また、プログラム名のエントリーは、hptLinkageProperties パラメーターが参照するファイルに存在しなければなりません。

hptEntryPage または hptEntryApp のいずれかが必須です。 両方を指定した場合は、hptEntryPage が使用されます。

hptEntryPage /entry_page_jsp 文書ルートを基準とした JSP エントリー・ページを指定します。

hptEntryPage または hptEntryApp のいずれかが必須です。 両方を指定した場合は、hptEntryPage が使用されます。

JSP エントリー・ページの HTML 出力では、ユーザーに呼び出される Web トランザクションの名前を、 hptAppId に割り当てなければなりません。 また、Web トランザクションを呼び出す実行ボタンの名前は hptExec、 Web アプリケーション・サーバーのセッションを終了する実行ボタンの名前は hptLogout でなければなりません。

Vagen1EntryPage.jsp は、作業用サンプルとして提供されます。 そこでは、各 Web トランザクション名は、<SELECT> 構造体の VALUE 文節に含まれており、その構造体の NAME 文節により hptAppId を参照します。

hptErrorLog gateway_servlet_log_file オプション。 ログ・ファイルの完全修飾パスを指定します。 このパラメーターを指定した場合、ゲートウェイ・サーブレットによってイベントとエラーのトレースが提供されるので、 このログを使用して障害を診断することができます。 hptErrorLog を除去すると、トレースはオフになります。
hptExpiredPasswordPage /expired_password_page _jsp オプション。文書ルートを基準とした JSP 失効パスワード・ページを指定します。

JSP 失効パスワード・ページ の HTML 出力では、ユーザー ID 入力フィールドの名前は hptUserid、旧パスワード入力フィールドの名前は hptPassword、新パスワード入力フィールドの名前は hptNewPassword、新パスワード入力の確認フィールドの名前は hptConfirmNewPassword、および実行ボタンの名前は hptExpiredPasswordPageLogin でなければなりません。

ExpiredPasswordPage.jsp は、作業用サンプルとして提供されます。

hptExpiredPasswordPage パラメーターは、 hptLogonCheck も指定している場合のみ効力があります。

hptGatewayProperties gateway_properties_file オプション。その他のゲートウェイ・サーブレット・パラメーターを含むファイルの完全修飾パスを指定します。
hptIDManageHost host_name オプション。Session ID Manager が実行されているマシンの TCP/IP ホスト名を指定します。 デフォルトは、localhost です。
hptLinkageProperties linkage_properties_file 必須。リンケージ・プロパティー・ファイルの完全修飾名を指定します。 このファイルによって、ゲートウェイ・サーブレットと各 Web トランザクション間の接続を確立します。 『リンケージ・プロパティー』を参照してください。
hptLogonCheck fully_qualified_class_name オプション。ユーザー認証を処理する logon-check クラスを指定します。

RACFValidateLogin は、 作業用サンプルとして 提供されます。 そのサンプルを使用 するには、次のように 指定します: hptLogonCheck= com.ibm.hpt. gateway.RACFValidateLogin

hptLogonPage /logon_page_jsp オプション。文書ルートを基準とした JSP ログオン・ページを指定します。 このパラメーターを省略した場合、または hptPublicPassword および hptPublicUserid が存在する場合は、ログオン・ページは表示されません。

JSP ログオン・ページの HTML 出力では、ユーザー ID 入力フィールドの名前は hptUserid、パスワード入力フィールドの名前は hptPassword、および実行ボタンの名前は hptLogin でなければなりません。

Vagen1LogonPage.jsp は、JSP の作業用サンプルとして提供されます。

以下は、ゲートウェイ・プロパティー・ファイルの例です。
hptLogonPage=/Vagen1LogonPage.jsp
hptEntryPage=/Vagen1EntryPage.jsp
#hptEntryApp=WEBTXN1
hptErrorLog=c:/traces/Vagen1Gateway.log
hptLinkageProperties=c:/linktabs/csogwLinkage.properties
# use the following property if using Websphere 2.0,
# which uses JSP 0.91 and Servlet 2.0 support
#hptServletVersion=2.0

関連タスク
Web トランザクションを実行するようにプロジェクトを構成する
EGL Web プロジェクトへの Web トランザクション・サポートの追加

関連リファレンス
リンケージ・プロパティー

フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.