チュートリアル

セッション・マネージャー API

  • ZIEWeb-Client は、Session Manager API と呼ばれる特殊な API もサポートします。これらの JavaScript ベースの API は、アプリケーション開発者がホストセッションとホストセッションとのテキストベースの相互作用を管理するのに役立ちます。

構成の詳細とサポートされる API のリストの詳細を確認するには、 HCL Software ブログSession Manager APIに関するブログを参照してください。

関数更新 HTMLParameters()

  • この関数の目的は、セッションプロパティーを動的に変更することです。この関数は、接続の作成が確立される前に呼び出されます。上書きされた値は、管理者が設定した最初のセッションプロパティよりも優先されます。上書きされたプロパティはロックされているため、ユーザーは変更できません。

パラメータを設定するステップ:

オプション-1:

  • json 配列を作成し、以下のメソッドに渡します。

    変数 hod_applet = new hod_Session();変数 json_object ={“host”:”host_address”,”port”:”23”} hod_applet.setHTMLParametersToOverride(json_object);

オプション-2:

  • 以下の関数を繰り返し呼び出す json 配列を作成します
  • 以下の API を使用して、json オブジェクトを ZIEWeb-Client に渡します

    変数 hod_applet = new hod_Session(); hod_applet.setHTMLParametersToOverride("ホスト","ホスト ADDRESS"); hod_applet.setHTMLParametersToOverride ("ポート","12175"); hod_applet.setHTMLParametersToOverride(); //Finally this to Call set メソッド

セッションプロパティーの動的変更:

  • デフォルトでは、セッション定義は管理者が定義します。HTML パラメータを上書きすることで、クライアントサイドでセッションプロパティを変更できます。特定のセッションプロパティーのみを上書きできます。それらは、ホスト、ポート、コードページ、LUName、ワークステーション ID、画面サイズです。
  • 上書きされた値は、管理者が設定した両方の初期セッションプロパティよりも優先されます。
  • 上書きされたプロパティはロックされているため、ユーザーは変更できません。

詳しくは、 HCL Software ブログでのセッションプロパティーの動的な変更に関するブログを参照してください。

配置ウィザードにパラメータを追加:

  • HTML パラメータを含める必要があります

    EnableHTMLOverridesを入力し、true に設定します (デプロイウィザードで、詳細オプション à HTML パラメータ)。

  • HTML パラメータを含める必要があります

    上書きを受け入れるセッションの正確な名前の値を持つTargetedSessionList 。 (デプロイウィザードで、詳細オプション à HTML パラメータ)

上書きできるセッションプロパティのリストを以下に示します:

パラメーター名 説明 有効な値
ホスト ターゲットサーバーのホスト名または IP アドレス。プロパティーパネルに「宛先アドレス」として表示されます。すべてのセッションタイプに適用 ホスト名または IP アドレス
ホストバックアップ1 backup1 サーバーのホスト名または IP アドレス。プロパティパネルにバックアップの「宛先アドレス」として表示されます。すべてのセッションタイプに適用されます。 ホスト名または IP アドレス
ホストバックアップ2 backup2 サーバーのホスト名または IP アドレス。プロパティパネルにバックアップ 2 の「宛先アドレス」として表示されます。すべてのセッションタイプに適用されます。 ホスト名または IP アドレス
ポート ターゲットサーバーが待機しているポート番号です。プロパティーパネルに「宛先ポート」として表示されます。すべてのセッションタイプに適用されます。 有効な任意の TCP/IP ポート番号。
ポートバックアップ1 backup1 サーバーが待機しているポート番号です。プロパティパネルに backup1 の「宛先ポート」として表示されます。すべてのセッションタイプに適用されます。 有効な任意の TCP/IP ポート番号。
ポートバックアップ2 backup2 サーバーが待機しているポート番号です。プロパティパネルにバックアップ 2 の「宛先ポート」として表示されます。すべてのセッションタイプに適用されます。 有効な任意の TCP/IP ポート番号。
コードページ セッションの接続先サーバーのコードページ。プロパティパネルに「ホストコードページ」として表示されます。FTP を除くすべてのセッションタイプに適用されます。 セッション プロパティ パネルにリストされている、サポートされているホスト コードページの数値部分 (例 037)。
LUName このセッションが接続したいターゲットサーバーで定義された LU または LU プールの名前。プロパティーパネルに「LU またはプール名」と表示されます。3270 表示および 3270 印刷のセッションタイプに適用されます。 LU または LU プールの名前。
LUNameBackup1 このセッションを接続したい、backup1 サーバーで定義された LU または LU プールの名前。プロパティーパネルに、backup1 の「LU またはプール名」と表示されます。3270 表示および 3270 印刷のセッションタイプに適用されます。 LU または LU プールの名前。
LUNameBackup2 このセッションが接続したい、backup2 サーバーで定義された LU または LU プールの名前。プロパティーパネルに、backup2 の「LU またはプール名」として表示されます。3270 表示および 3270 印刷のセッションタイプに適用されます。 LU または LU プールの名前。
WorkstationID このワークステーション名。プロパティパネルに「ワークステーション ID」として表示されます。5250 表示および 5250 印刷セッションタイプに適用されます。 このワークステーションの固有の名前。
ScreenSize 画面の行数と列数を定義します。プロパティパネルに「画面サイズ」として表示されます。3270 表示、5250 表示、および VT 表示のセッションタイプに適用されます。
  • 値=行 x 列
  • 2=24x80 (3270、5250、VT)
  • 3=32x80 (3270)
  • 4=43x80 (3270)
  • 5=27x132 (3270, 5250)
  • 6=24x132 (VT)
  • 7=36x80 (VT)
  • 8=36x132 (VT)
  • 9=48x80 (VT)
  • 10=48x132 (VT)
  • 11=72x80 (VT)
  • 12=72x132 (VT)
  • 13=144x80 (VT)
  • 14=144x132 (VT)
  • 15=25x80 (VT)
  • 16=25x132 (VT)

管理者は、以下のいずれかの方法を使用してカスタムパラメータを設定します。

  1. 展開ウィザードですべてのパラメータを設定する。
  2. または、カスタム JSP コードの使用 (カスタム UX の一部として提供される機能)。テンプレートファイルで、すべてのカスタムパラメータを使用して hHod_AppletParams 変数を更新します。

    例:
    hHod_AppletParams["host"] = "host_address"; hHod_AppletParams["port"] = "port_number";
  3. または、以下のいずれかの方法を使用して、セッションマネージャ API 経由でパラメータを設定する。
    • オプション-1:
      • json 配列を作成し、以下のメソッドに渡します。

        変数 hod_applet = new hod_Session();変数 json_object ={“host”:”host_address”, ”port”:”23”} hod_applet.setHTMLParametersToOverride(json_object);
    • オプション-2:
      • ステップ 1: 以下の関数を繰り返し呼び出す json 配列を作成します。
      • ステップ 2: 以下の api を使用して、json オブジェクトを ZIEWeb-Client に渡します。
        変数 hod_applet = new hod_Session(); hod_applet.setHTMLParametersToOverride("ホスト","ホスト ADDRESS"); hod_applet.setHTMLParametersToOverride ("ポート","12175"); hod_applet.setHTMLParametersToOverride(); //Finally this to Call set メソッド

制限:

セッションマネージャー API (アプリケーションプログラミングインターフェース) は自動開始セッションでは動作しません。
アプリケーション・サーバー:
  • Tomcat での ZIEWeb クライアントサポートバージョン 9.xx以下のサポート。
  • マクロの再生中に WAR ファイルを Tomcat Appserver にデプロイした後、中間画面で [続行] を押すと、セッションが切断されます。
WEL & SSO マクロ:
  • サーバーを起動する前に、ユーザーはDB jar (例: DB2) をサーバー/アプリケーションの lib フォルダに置く必要があります。 (WAR からのすべての Lib は、ZIEWEB クライアントアプリケーションで動作するように EAR にコピーする必要があります)

    メモ: EAR と WAR ファイルのデプロイの場合、デプロイされた Jar 名をMANIFEST.INFファイルで言及する必要があります。

  • SSO マクロの代替開始画面」オプションはサポートされていません。 (今後さまざまなセッションで使用します)
  • マクロの自動開始オプションは、SSO マクロ記録の後に表示されません。
  • 構成ベースの Web Express Logon は実装されていません。
  • AutoStart マクロは、マクロが ZIEWEB クライアント終了に記録されているときは動作しません。

Web.properties:

非公開ディレクトリの Web.properties のPrintSessionの PrintedFileLocal またはカスタム UI のテンプレートURL のパスを追加するときに、1 つのバックスラッシュの代わりに 2 つのバックスラッシュを使用します。

: D:\フォルダ名\FileName.jsp の代わりに D:\フォルダ名\FileName.jsp

印刷セッション:
印刷されるファイルは、次の場合に (共有/ネットワークロケーションの使用時) カスタマイズされたディレクトリに保存されません:
  • Windows - IBM WAS と埋め込みアプリケーションサーバー。
  • RHEL - Tomcat、WLP、IBM WAS、埋め込みアプリケーションサーバー。
  • z/OS - 組み込みアプリケーションサーバー
  • Touch デバイスから ZIEWeb Client HTML ページを開く

代わりに、アプリケーションサーバーの場所に保存されます。

ホストコードページの追加 – DBCS サポート:
  • セッションの開始時に、管理コンソールは DBCS のいくつかのプロパティをサポートしません。
  • DBCS セッション中、上書き、バックスペース、削除などの操作はサーバー上で行われます。このため、DBCS 文字のコピーと貼り付けは部分的には機能しますが、連続して DBCS 文字を貼り付けた場合、期待どおりに機能しません。
ホストファイル転送:
  • 「ファイル転送ホスト」→「送信」ファイル転送は、Tomcat バージョン v9.xx Application Server では機能しません。
  • DBCS セッションで、ホストファイル転送とホストファイル印刷が機能しない。ファイル転送とファイル印刷後に、予期した文字がユーザーに表示されません。

カスタマイズ属性に無効なファイル名文字

ファイル名やフォルダには、正しくない次の文字や記号を使用しないでください。
  • ポンド
  • % パーセント
  • アンパサンド(&A)
  • { 左中括弧
  • 右中括弧
  • \ バックスラッシュ
  • < 左山かぎ
  • > 直角括弧
  • * アスタリスク
  • ? ?
  • / スラッシュ
  • 空白
  • $ ドル記号
  • !感嘆符
  • ' 一重引用符
  • " 二重引用符
  • : コロン
  • @ アットマーク
  • + 正記号
  • ` 戻し
  • |パイプ
  • = 等号