本文へジャンプ

System i スペシャリストが教えるV5 ちょっと、イイ話

第6回：WebFacing Tool

WASへの登録とアプリケーションの実行

WebFacing Toolで作成したアプリケーションをサーバー上で実行するには、WAS（System i ）にエクスポートして、Webアプリケーションとして登録します。

  1. まず、WASにエクスポートします。　WSSDaの‘ファイル’⇒‘エクスポート’⇒‘WARファイル’を選択して、‘次へ’ボタンを押します。

    1) ‘どのリソースをエクスポート…’からエクスポート対象のWebFacingプロジェクトを選択します。 2) ‘どこにリソースをエクスポート…’には、エクスポート先となるiSeriesのIFSのディレクトリー、warファイル名を指定します。（拡張子は*.warとします。）
    ディレクトリー、warファイル名は任意です。（上図では RドライブにiSeriesのIFSの
    /　(ルート)　をマッピングしています。また、/home/DEMOKというサブディレクトリーを作成しています。）ファイル名の拡張子は*.war　とします。上図ではR:\HOME\DEMOK\DEMOK.warと指定しています。
    ＊注 WASからアクセスされるIFSディレクトリー、ファイルには　QEJB, QJEBSVRユーザー・プロフィールに対するアクセス権限が付与されている必要があります。

    CHGAUTコマンド、またはWRKLNKコマンドからオプション9で権限編集画面を開き、QEJB, QEJBSVRに*RWX, *ALL権限を付与してください。

    例）　CHGAUT OBJ('/home/DEMOK') USER(QEJB QEJBSVR) DTAAUT(*RWX) OBJAUT(*ALL)

  2. WASへの登録
    WAS管理コンソールから1.でエクスポートしたwarファイルをWASに登録します。

    WAS管理コンソールのメニューの‘コンソール’⇒‘ウィザード’⇒‘エンタープライズ・アプリケーションのインストール’を選択します。

    1) ‘インストールするスタンドアロン・モジュール’にチェックします。

    2) ‘ノード上のファイルの参照’はWASが導入されたSystem iのホスト名を選択します。

    3) ‘パス’にはWebFacing ToolからエクスポートしたIFSパス、warファイル名を指定します。‘参照’ボタンを押すと‘オープン’というウィンドウが表示され、ここからIFSのパス、warファイル名を選択することができます。上図では　/home/DEMOK/DEMOK.war　と入力します。


    4) ‘アプリケーション名‘には任意のWebアプリケーション名を指定します。この名前はWASコンソールから見えるWebアプリケーション名となります。

    5) ‘Webモジュールのコンテキスト・ルート‘はブラウザーで指定する際のパスの一部となります。

    上図の例の場合、ブラウザーのURLは「http://ホスト名:ポート番号/DEMOK/index.htmlと指定してWebFacing で生成したWebアプリケーションを開始することになります。（URLの/DEMOKの部分にコンテキスト・ルートの値が反映されます。）

    6) ‘次へ’ボタンを押します。

    7) その後、何も変更せずに‘次へ’ボタンを数回クリックします。

    8) ‘Webモジュールの仮想ホストの選択’画面で、WASで定義してある仮想ホスト名を選択します。デフォルトでは‘default_host’ を選択します。

    9) ‘アプリケーション・サーバーの選択’画面では、WASで定義してあるアプリケーション・サーバーを指定します。デフォルトでは‘Default Server’を選択します。



    10) 最後の画面まで‘次へ’ボタンを押します。　最後の画面では‘終了’ボタンを押します。　指定の内容でWebアプリケーションが登録されます。

    11) 登録が完了すると、下図のようにWASコンソール上にアプリケーションがWebモジュールとして表示されます。


    12) WASへの登録が完了したら、‘ノード’⇒‘ホスト名（例ではosa270）’⇒　右クリック　として‘Webサーバー・プラグインの再生成’をクリックします。

    　

    Webサーバー・プラグインの再生成を実施した後は、httpサーバーを停止・再起動してプラグインの変更を反映します。
    以上でWASへの登録が完了します。

    最後にアプリケーション・サーバー（デフォルトでは‘Default Server’）　を再始動します。（‘Default Server’を右クリック　⇒‘停止’を選択し、その後‘始動’をクリック）

WebFacingアプリケーションの実行

  1. クライアントでIEを起動し、以下のようにURLを指定します。

    HTTP://(ホスト名):(ポート番号)/(Webモジュールのコンテキスト・ルート)/index.html

    例）
    HTTP://osa270:9080/DEMOK/index.html

    以下のようなhtmlファイルが表示されます。(以下の例では見出し、フォント、背景などを修正しています。)


  2. index.html上には2つのリンクが生成されています。上のリンクをクリックすると、このブラウザー上で画面が遷移してWebFacingアプリケーションが実行されます。下のリンクをクリックすると、新しいブラウザー・ウィンドウが起動して、その画面でWebFacingアプリケーションが実行されます。どちらのリンクを使用しても実行される内容は同じです。

  3. WebFacingプロジェクトで変換を行う際、“サインオンのプロンプト”を選択していた場合、以下のようなlogon.htmlが表示されます。ユーザー・プロフィール、パスワードを入力し、‘Logon’ ボタンを押します。
    また、‘指定値でサイン・オン’を指定していた場合、logon.htmlは表示されず、指定のユーザー・プロフィールでWebFacingのアプリケーションが実行されます。

    (以下の画面の例は見出し、フォント、色のみオリジナルを変更しています。)


  4. WebFacing ToolでDSPFから変換されたメニュー画面がJSPで表示されます。以降の操作は通常の5250画面と同じように進めていきます。

    ＊注
    上図ではメニューの、2、3、7にリンクが設定されていますが、これは後からWDScに含まれるCODE設計機能を使用して追加修正したものです。

  5. サブファイル画面も自動的に変換されます。（サブファイル行の色、フォントなどは変更しています。）また、WDSc V4.0のWebFacing Toolを使用して変換すると、PFキーでの操作も可能です。


  6. WDSc SP2以降では、5250画面からの入力と同様に上書きモードで入力データの変更ができます。


  7. DDSウィンドウなども正常に変換されます。


  8. WebFacingアプリケーションを終了する時は、必ず‘終了’ボタンを押して、一番始めの index.html　の画面まで戻ってから終了させてください。
    WDSc SP3以降を適用した環境で生成したWebFacingアプリケーションでは、index.html以外の画面でブラウザーをクローズすると、以下のようなメッセージが出てバックグラウンドの対話型5250アプリケーションをクローズ（ENDJOB）しますので安全性は向上しています。しかし、原理的にはPCOMをサインオフせずクローズするのと同じ状況になりますので、極力避ける方が良いでしょう。

WebFacing Toolの考慮点

  1. DDSキーワード
    WebFacing ToolではサポートされないDDSキーワードがあります。下記のURLを参照してサポート対象外のDDSキーワードについて事前に確認してください。

    WebSphere Development Studio Client for iSeries　より‘DDS Keywork support’をクリック
    PRINTキーワードや、DSPATRキーワードなどはサポートされていません。（サポートされないDDSキーワードの存在＝WebFacingアプリケーションとして実行不可ではありません。例えばDSPATRキーワードの場合、その表示属性が無視されたJSPが生成されます。DSPATRキーワードの属性が表示されなくても良いならば、アプリケーションの実行そのものは問題なく行なえます。ただし、INVITEキーワードのように、アプリケーション実行時にエラーとなるDDSキーワードも存在します。）
  2. DDSキーワード・サーベイツール
    以下のURLよりDDSキーワードのサポート状況を確認するプログラムをダウンロードすることができます。
    WebSphere Development Studio Client for iSeries より‘Download’を選択し、リストから‘DDS Keyword Survey Tool’をダウンロードします。（検索条件に“DDS Keyword Survey“などを入力して検索します。）
    Survey.savfがダウンロードされるので、これをSystem iにFTPまたはネットサーバーでアップロードしてください。
    その後、RSTLIBコマンドで SURVEY ライブラリーを復元してください。
    サーベイを実行するには　SURVEYライブラリーの中にあるSURVEYコマンドを実行します。
  3. 端末IDの固定ができません。
    WebFacing Toolでは端末IDの固定ができません。（多数のブラウザーからリクエストが同時に開始された時のパフォーマンス向上のため）
  4. WebFacingアプリケーションでログオン時に使用されるユーザー・プロフィールの　初期プログラム（INLPGMパラメーター）は無視され、実行されません。
    また、LMTCPB(*YES)のユーザー・プロフィールでは、WebFacing アプリケーションは実行できません。
  5. 変換対象となるDSPF DDSソース内に外字を含んでいると変換エラーとなります。外字を除外する必要があります。またフィールド名に‘\’ を含めることができません。
  6. WebFacing Toolは標準で印刷機能をサポートしていません。印刷機能が必要な場合、PCOMやHPT、OS/400 V5R2+PSF/400によるスプール・ファイル→PDF変換機能などを利用して、印刷の仕組みを考慮する必要があります。
  7. TOOLBOX罫線の含まれたDSPFのDDSソースをそのまま変換するとWebFacingで作成したアプリケーションのJSP画面が異常終了する場合があります。
    WebFacing Tool導入ガイド(第三版) にある資料を参考にしてDSPF DDSソースのTOOLBOX罫線行の次行にWebFacing専用のコメント行（ A*%%WB 4 FLD ）を追加してください。
  8. WebFacing Toolで使用するユーザーのCCSIDは5035である必要があります。

【参考文献】

上に戻る

WebFacing Tool