デフォルトでは、ゲートウェイ・サーブレットには 1 つのパラメーター、 hptGatewayProperties パラメーターのみが定義されています。 このパラメーターはゲートウェイ・プロパティー・ファイルを指定します。 ゲートウェイ・プロパティー・ファイルは、ゲートウェイ・サーブレットの残りのパラメーターを設定します。 デフォルトでは、ゲートウェイ・プロパティー・ファイルは、 JavaResources¥JavaSource フォルダーの gw.properties ファイルです。 このファイルのコメントは、ポンド記号 (#) で始まります。
もう 1 つの選択肢として、hptGatewayProperties パラメーターを指定する同じ場所に ゲートウェイ・サーブレット・パラメーターを設定することもできます。しかし、 パラメーターは、ゲートウェイ・プロパティー・ファイルに設定する方が一般的です。 ゲートウェイ・プロパティー・ファイルのパラメーターは、Web アプリケーション・サーバーでの指定に優先します。
リンケージ・プロパティーは、リンケージ・プロパティー・ファイルに設定されます。 このファイルは、hptLinkageProperties ゲートウェイ・サーブレット・パラメーターに指定します。 『リンケージ・プロパティー』を参照してください。
サーブレット・パラメーター | パラメーター値 | 注意 |
---|---|---|
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 トランザクション・サポートの追加
関連リファレンス
リンケージ・プロパティー