...

Uniface インストール/構成 ガイド(iSeries 版)

by user

on
Category: Documents
205

views

Report

Comments

Transcript

Uniface インストール/構成 ガイド(iSeries 版)
Uniface インストール/構成
ガイド(iSeries 版)
Uniface 9
文書番号 10115119201-00
2008 年 8 月
Uniface 9.2.01
Uniface インストール/構成ガイド(iSeries 版)
Revision 0
本書および本書に記載されている製品には、以下のことが適用されます。
アクセスは、許可されたユーザーに制限されています。この製品の使用には、ユーザーと
Compuware Corporation との使用権許諾契約の条項が適用されます。
© 2003-2007 Compuware Corporation. All rights reserved. この未公表著作物は、アメリカ合衆国
著作権法により保護されています。
アメリカ合衆国政府の権利
アメリカ合衆国政府による使用、複製、または開示に関しては、Compuware Corporation のライ
センス契約に定められた制約、および DFARS 227.7202-1(a) および 227.7202-3(a) (1995)、
DFARS 252.227-7013(c)(1)(ii)(OCT 1988)、FAR 12.212(a) (1995)、FAR 52.227-19、または FAR
52.227-14 (ALT III) に規定された制約が、適宜、適用されます。Compuware Corporation.
この製品には、Compuware Corporation の秘密情報および企業秘密が含まれています。
Compuware Corporation の書面による事前の許可なく、使用、開示、複製することはできません。
Compuware、Uniface Flow、Uniface View、および Uniface は、Compuware Corporation の商標
または登録商標です。
Acrobat® Reader copyright © 1984-2006 Adobe Systems Incorporated. All rights reserved.
Adobe、Acrobat、および Acrobat Reader は、Adobe Systems Incorporated の商標です。
その他の会社名、製品名は、関連する各社の商標または登録商標です。
発行日:2008 年 8 月 1 日
目次
はじめに
対象読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
用語
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
ドキュメントの表記法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
マニュアルの記載内容に関する注意事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
第 1 章 インストールと構成
1.1
iSeries のインストール要件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2
iSeries への Uniface のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3
インストール ユーザー プロファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4
TCP/IP 接続の確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.5
iSeries へのインストールの準備 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.6
iSeries への DLM のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.6.1 DLM ライセンスの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.7
iSeries での Uniface のインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.7.1 既存のインストール上へのインストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.7.2 インストール内容 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
1.8
Uniface ランタイム環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.8.1 Uniface サーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.8.2 Uniface ルーター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.8.3 Uniface Web アプリケーション サーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.8.4 Uniface Web リクエスト ディスパッチャ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
20
21
22
23
第 2 章 iSeries への Uniface のインストール
2.1
iSeries でのファイル アクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
2.2
iSeries での Uniface の構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.3
iSeries での DB2 データベース アクセスの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
2.3.1 DDS で生成した物理ファイルの定義のロード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
iii
2.4
iSeries での Uniface ルーターの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.1 Uniface サーバー用の UST の定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.2 Uniface サーバーの事前起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.3 Uniface ルーターへのクライアントの登録 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.4 Uniface ルーターのスタートアップ パラメータの変更 . . . . . . . . . . . . . . . . . . . . . . . .
2.4.5 iSeries での Uniface ルーターの起動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4.6 Uniface ルーターの実行の確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
35
36
38
40
41
42
2.5
iSeries での Uniface デプロイメント ユーティリティの実行 . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.5.1 iSeries での Uniface サービスの実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2.5.2 iSeries での Uniface バッチ アプリケーションの実行 . . . . . . . . . . . . . . . . . . . . . . . . . 45
第 3 章 Web デプロイメントの構成
3.1
iSeries での Web 実行環境の構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.1 iSeries での wrd.war ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.2 新たな WebSphere アプリケーション サーバーの作成 . . . . . . . . . . . . . . . . . . . . . . . .
3.1.3 WebSphere アプリケーション サーバーへの WRD のインストール . . . . . . . . . . . . . .
3.1.4 WebSphere での WRD のテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
47
47
50
52
54
3.2
iSeries での USP と Web サービスの配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.1 iSeries での Uniface Web アプリケーション サーバーの構成 . . . . . . . . . . . . . . . . . . .
3.2.2 サービスの作成と実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.3 Web サービスとしてのサービスの実行 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
55
55
56
57
第 4 章 構成ファイル
4.1
アサインメント ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.1 アサインメントのシンタックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.2 パスとパスの割り当て . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.3 インストール後に使用できるパス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.4 2 パス構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
パスとコネクタの割り当て . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.1 データベース コネクタ パス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.2 ネットワーク コネクタ パス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.3 Uniface サーバー コネクタ パス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.4 ルーターのホップ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.5 DBMS チャネル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.6 ログオン情報 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
61
62
63
65
66
66
67
67
68
70
70
70
4.3
構成ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.1 dbms.asn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.2 idf.asn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.3 urouter.asn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.4 wasv.asn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3.5 web.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
71
71
72
74
80
80
4.4
アサインメント設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
4.2
iv Uniface インストール/構成ガイド(iSeries 版)
4.4.1
4.4.2
4.4.3
4.4.4
4.4.5
$DNP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
$MAXCLIENTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
$MAXSERVERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
$MAXMONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
$PUTMESS_LOGFILE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83
83
84
84
85
第 5 章 実行可能ファイルとスイッチ
5.1
urouter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5.2
userver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5.3
コマンド ライン スイッチ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.1 /asn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.2 /dnp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.3 /dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.4 /ex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.5 /gates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.6 /hostrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.7 /max . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.8 /maxidle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.9 /maxreq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.10/pri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.11/shr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.12/su . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.13/ust . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
88
88
89
90
90
92
93
94
94
95
95
97
98
99
日本コンピュウェア株式会社テクニカル・サポートのご案内 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
v
vi Uniface インストール/構成ガイド(iSeries 版)
はじめに
このガイドでは、iSeries(AS/400)に Uniface 製品をインストールする方法について説明します。
このガイドの情報は、Uniface の主要ドキュメントである Uniface Library にもあります。データ
ベース コネクタ、ネットワーク コネクタ、およびサードパーティ統合サポートの構成に関する追
加情報が掲載されています。Uniface Library は、Uniface インストール CD-ROM に収録されてい
ます。また、Web サイトの FrontLine Uniface (frontline.compuware.com/products/uf/
default.asp) のドキュメント ページでも定期的に更新された最新版が公開されています。
対象読者
このガイドは、読者が iSeries について理解していることを前提に書かれています。インストール
作業を行うには、少なくとも IBM iSeries のシステム オペレータ ワークショップと同等のトレー
ニングを受けている必要があります。
用語
最新バージョンの OS/400(V5R3 以降)は OS/400 ではなく、i5/OS と呼ばれています。このマ
ニュアルでは簡易性を考えて、OS/400 と i5/OS のどちらも、単に「OS/400」とすることにしま
す。
OS/400 および i5/OS を実行するハードウェアも同様に、AS/400、AS/400e、iSeries、i5 など、さ
まざまな名称があります。Uniface の場合、ハードウェアによる違いはないため、これらすべての
タイプのハードウェアを「iSeries」と呼ぶことにします。
vii
ドキュメントの表記法
Uniface のドキュメントでは、Uniface 製品のシンタックスとユーザー インタフェースの記述にさ
まざまな表記法を採用しています。
シンタックスの記述
PROC ステートメントと PROC 関数、構成とアサインメント設定、API オペレーションなどのシ
ンタックスには、以下の表記が使用されています。
シンタックスの表記法
表記法
説明
対象
Exact String
等幅フォントの情報は、表示されてい
るとおりに指定する必要があります。
コマンド、オプション、スイッチ
VariableContent
斜体の情報は、実際の値に置き換える
パラメータ、値、変数
必要があります。
{ ... }
波かっこはオプション情報を示すのに
使われます。
オプションの引数、パラメータ、オプショ
ン、値、スイッチ
|
縦棒はオプションのリストを区切るた
めに使用され、1 つの項目しか入力で
きません。
互いに排他的な引数、パラメータ、オプ
ション、値、スイッチ
;,!
リスト内の下線付き句読点は、GOLD;
や GOLD, などの GOLD 区切り文字を
示します。
リストやサブリストを含む文字列
たとえば、以下の構文は、rollback 命令は、あとに示す引数がなくても、2 つのオプション引数
のどちらか 1 つを指定しても実行できることを示しています。
rollback {"Connector" | "$Path"}
この構文の記述に従うと、以下の形の rollback ステートメントを使用できます。
rollback
rollback "SYB"
rollback "$MYPATH"
viii
Uniface インストール/構成ガイド(iSeries 版)
字体の汎用的な表記法
字体の表記法
表記法
説明
対象
^FUNCTION
カレット(^)と大文字で示す語
ストラクチャ エディタ ファンクショ
ンの名前
キーストローク
太字フォント
ファンクション キー、キーの組み合
わせ 例:[F1]
続けて押すキーとキーの間にはス
ペースが入ります。
同時に押すキーとキーの間には +
が入ります。
GOLD キーの組み合わせ 例:GOLD
R
アクセラレータ キーとアクセス キー
例:[Alt]+[F4]
[ ウィンドウ名 ] と
[ プロパティ ]
角かっこ([ ])で囲まれた太字
フォント
ユーザー インタフェースのウィンド
ウ名、フィールド名、プロパティ名、
キーボード上のキーなど
Values, Proc
instructions,
configuration
settings
等幅フォント
フィールド、変数、プロパティの値
FilePath
太字等幅フォント
PROC 言語の命令と API
アサインメント設定、初期化設定
ディレクトリ名とファイル名
マニュアルの記載内容に関する注意事項
このマニュアルは、英語版のマニュアルを基に翻訳され、作成されています。そのため、日本では
販売されていない製品やサポートされていない機能についての記述が含まれることがあります。
ix
x
Uniface インストール/構成ガイド(iSeries 版)
第 1 章 インストールと構成
CD-ROM のインストール プログラムによって、Uniface 製品コンポーネントに必要なディレクト
リ、ファイル、および実行可能ファイルがコピーされます。
メモ:必ずクリーンなディレクトリに Uniface をインストールしてください。既存の Uniface
インストールにはインストールしないでください。
インストールする製品は、保有する Compuware DLM ライセンスによって異なります。サポート
されているプラットフォームと製品の詳細については、FrontLine の「Uniface Platform
Availability (frontline.compuware.com/products/uf/tech/15616.asp)」を参照してください。
インストール後、ほとんどの Uniface 製品は構成作業を行わないと使用できません。Uniface 製品
の構成については、Uniface ライブラリの「Uniface と Uniface アプリケーションの構成」を参照
してください。データベース コネクタやネットワーク コネクタなどの統合サポートの構成につい
ては、該当する製品のドキュメントを参照してください。
readme ファイルには、インストールと構成に関する追加情報が記載されています。この情報は現
在のマニュアルよりも優先されます。
1
1.1 iSeries のインストール要件
Uniface をインストールする前に、以下のエリアですべての要件を満たしていることを確認してく
ださい。
要件
説明
OS/400 オペレーティ
ング システムのバー
ジョンとリリース
iSeries システムは、i5/OS V5R1 以上のレベルが必要です。
ディスク スペース
インストール時に、200MB 以上のディスク スペースが必要です。インストールさ
れたソフトウェアの使用ディスク スペースは約 118MB です(インストールを終了
してログオフした、あるいは QTEMP をクリアしたあと)。自己展開型の実行ファ
イルを使用する場合、展開された Uniface 配布ファイルに、さらに 100MB のディ
スク スペースが必要です。
IFS(Integrated File
System)の知識などの
iSeries の経験
iSeries 環境とシステム設定について精通している必要があります。Uniface は、
TCP/IP 通信だけをサポートしています。少なくとも IBM AS/400 システム オペ
レータ ワークショップと同等の iSeries トレーニングを受けている必要がありま
す。一部のコンポーネントは IFS(Integrated File System)にインストールされる
ため、IFS の実用的な知識も必要です。
Uniface 製品の知識
Uniface ルータと Uniface サーバーの機能と使用方法について精通している必要が
あります。
インストール メディア
2
V5R2 と V5R3 については、DB2 トリガ起動に関連する OS/400 の問題が確認さ
れ、IBM に APAR SE19490 という ID で登録されています。このトリガは Uniface
の外側で定義されるため、V5R2 には PTF SI1761 を、V5R3 には SI17658 をそれ
ぞれ適用して、Uniface でのデータベース操作の実行時にそのトリガが正しく起動
するようにする必要があります。
インストール メディアは、CD-ROM、またはインターネットからダウンロードす
る自己展開型の ZIP ファイルです。iSeries プラットフォーム用の Uniface 製品は
すべて、同じメディアで一緒に提供されます。NFS マウント ドライブからのイン
ストールは推奨されないため、サポートされていません。詳細については、
「iSeries への Uniface のインストール」を参照してください。
ライセンス情報
Uniface では、ライセンス管理に Distributed License Management 4.1(DLM 4.1)
を使用します。この製品は Uniface のインストール CD に入っています。また、電
子配布によって提供されます。Uniface を使う前に、DLM をインストールする必要
があります。まず DLM をインストールしてライセンスを設定してから、Uniface
をインストールするという順序をお勧めします。
インストール ユーザー
プロファイル
iSeries システムの復元権限を持つユーザー プロファイルが必要です。iSeries の復
元コマンド RSTLIB と RSTOBJ は通常、*EXCLUDE のパブリック権限レベルで提
供されます。詳細については、「インストール ユーザー プロファイルの作成」を参
照してください。
Uniface インストール/構成ガイド(iSeries 版)
要件
説明
IFS のインストール ラ
イブラリとディレクト
リ
Uniface 製品オブジェクトを格納するライブラリ名を指定します。デフォルトのラ
イブラリ名は UNIFUVersion です。このマニュアルでは、ライブラリ名の例と
して UNIFxxxx が使用されています。
TCP/IP 接続
Uniface ルーターで使用できる TCP/IP ポートがあることを確認します。Uniface で
使用するデフォルトの TCP/IP ポート番号は 13001 です。詳細については、「TCP/
IP 接続の確認」を参照してください。
メモ: このマニュアルに記載されている OS/400 コマンドは、変更されていない iSeries システ
ムを前提としています。コマンドの実際の使用法は、ローカルでの変更や標準によって異なり
ます。お使いのシステムの詳細については、現地の管理者に問い合わせください。CL コマンド
STRSQL と RUNSQLSTM を実行するには、DB2 Query Manager と SQL Development Kit(57xxST1)が必要です。CL コマンド STRPDM と STRSEU を実行するには、WebSphere Application
Development Tool Set (57xx-WDS)が必要です。
1.2 iSeries への Uniface のインストール
インストール メディアは、CD-ROM、またはインターネットからダウンロードする自己展開型の
ZIP ファイルです。iSeries プラットフォーム用の Uniface 製品はすべて、同じメディアで一緒に提
供されます。
メモ:NFS マウント ドライブからのインストールは推奨されないため、サポートされていませ
ん。Uniface インストーラでは、CL コマンド CPY が使用されます。このコマンドには、NFS
マウント ディレクトリからローカル システムにコピーする際の既知の問題があります。
Uniface 配布ファイルが NFS マウント ディレクトリにある場合、インストーラは実行に失敗し
たり、ファイルのコピーに失敗したりすることがあります。
Uniface 製品を iSeries にインストールするには、以下の手順を実行します。
1
iSeries へのインストールに必要な要件をすべて満たします。「iSeries のインストール要件」を
参照してください。
2
Uniface 製品オブジェクトの所有者のユーザー プロファイルを作成します。「インストール
ユーザー プロファイルの作成」を参照してください。
第 1 章 インストールと構成
3
3
使用可能な TCP/IP ポートがあること、TCP/IP が動作していること、およびドメインが正し
く構成されていることを確認します。「TCP/IP 接続の確認」を参照してください。
4
必要に応じて、iSeries 上の IFS 共有に配布ファイルを抽出し、インストーラを復元します。
「iSeries へのインストールの準備」を参照してください。
これが必要になるのは、自己展開型の ZIP ファイルを使用している場合や、Uniface CD は手
元にあるものの、iSeries 自体の CD ROM ドライブにアクセスできない場合です。
5 (必要に応じて)DLM をインストールし、ライセンスを構成します。「iSeries への DLM のイ
ンストール」と「DLM ライセンスの構成」を参照してください。
6
Uniface 製品をインストールします。「既存のインストール上へのインストール」を参照してく
ださい。
1.3 インストール ユーザー プロファイルの作成
iSeries システムの復元権限を持つユーザー プロファイルが必要です。iSeries の復元コマンド
RSTLIB と RSTOBJ は通常、*EXCLUDE のパブリック権限レベルで提供されます。
以下に、ユーザー プロファイルと権限を設定する際のガイドラインを示します。
◆
Uniface をインストールするには、ユーザー プロファイルに QSECOFR と同レベルの権限を
設定することをお勧めします。ユーザー プロファイル QSECOFR がない場合は、iSeries のシ
ステム管理者にお問い合わせください。
◆
Uniface 製品オブジェクトの所有者として使用するユーザー プロファイルを特定します。この
ユーザー プロファイルの名前としては、UNIFSID をお勧めします。このマニュアルでは、こ
のユーザー プロファイル名を使用しています。QSECOFR や QSYSOPR のようなシステムが
提供するユーザー プロファイルは、オペレーティング システムで許可されません。インス
トーラを使用するユーザーには、*ALLOBJ 権限が必要です。UNIFSID に *ALLOBJ 権限を
与えたくない場合は、そのレベルの権限を持つユーザー プロファイルを選択して、
UROUTER(Uniface ルーター)の所有者をそのユーザー プロファイルに変更します。
◆
AS400INS を使用するユーザー、または LODRUN を実行するユーザーには、CL コマンド
CRTJOBD、CRTJOBQ、CRTSBSD、CRTCLS、CRTPRTF、RSTLIB、RSTOBJ、CPY、
CPYFRMSTMF に対して *USE 権限が必要です。あるいは、*ALLOBJ 権限と、サブシステ
ムを作成するために AS400INS を使用する場合は *JOBCTL 権限が必要です。
◆
さらに、このユーザー プロファイルには、DLM をインストールするために IFS のルート ディ
レクトリ(/)にディレクトリを作成する権限が必要です。
4
Uniface インストール/構成ガイド(iSeries 版)
ユーザー プロファイルを作成するには、以下の手順を実行します。
1
Uniface 製品オブジェクトの所有者のユーザー プロファイルを作成します。
CRTUSRPRF UNIFSID PASSWORD(Password)
USRCLS(*PGMR) SPCAUT(*ALLOBJ *JOBCTL)
TEXT('Uniface Product User Profile')
Password は、UNIFSID ユーザー プロファイルに関連付けるパスワードです。
メモ:UNIFSID は Uniface オブジェクトが保存されたときの所有者です。Uniface オブジェク
トの所有者を正しく設定し直すには、Uniface 製品をインストールする前に UNIFSID が存在し
なければなりません。
2
デフォルトの Uniface コード ページ以外のコード ページを使用する場合は、パラメータ
CCSID(CodePage) を追加する必要があります。
CodePage は、サポートされている Uniface コード ページの 1 つです。
表 1-1. iSeries でサポートされているコード ページ
コード ページ
CCSID
米国英語
37
ドイツ語
273
フィンランド語、スウェーデン語
278
イタリア語
280
スペイン語
284
フランス語
297
ヘブライ語
424
Latin-1(ベルギー語、スイス語)
500
Latin-2(多言語)
870
日本語英数カナ
930
韓国語
933
簡体字中国語
935
日本語英数小文字拡張
939
第 1 章 インストールと構成
5
表 1-1. iSeries でサポートされているコード ページ
コード ページ
CCSID
ドイツ語
1141
フィンランド語、スウェーデン語
1143
イタリア語
1144
スペイン語
1145
フランス語
1147
Latin-1(ベルギー語、スイス語)
1148
1.4 TCP/IP 接続の確認
TCP/IP 接続を確認するには、以下の手順を実行します。
1
Uniface ルーターが使用できる TCP/IP ポートがあることを確認します。
Uniface が使用するデフォルトの TCP/IP ポート番号は 13001 です。このマニュアルではこの
番号を使用しています。この TCP/IP ポートを Uniface のみが使用するように制限するには、
Uniface 用に TCP/IP ポートを予約します。
1 「GO CMDTCP」と入力し、[Add TCP/IP Port Restriction] を選択します。
2
制限されるポートの範囲と *TCP プロトコルを設定します。
3
UROUTER ジョブを所有するユーザー プロファイルを設定します。
TCP/IP ポートの割り当てはオプションで、変更するには *IOSYSCFG 権限が必要です。
2
TCP サービスが実行されていることを確認します。
TCP/IP インタフェースがアクティブになっていることを確認するには、WRKTCPSTS コマン
ドを使用し、オプション 1 を指定します。
3
TCP/IP ドメインが正しく構成されていることも確認します。
これを確認するには、CL コマンド CHGTCPDMN を使用します。[Host name] フィールドと
[Domain name] フィールドを正しく指定しないと、Uniface ルーターや Uniface サーバーは想
定どおりに動作しません。
1.5 iSeries へのインストールの準備
自己展開型の ZIP ファイルを使用している場合は、iSeries 上の IFS(Integrated File System)共
有にそのファイルを抽出し、インストーラを復元する必要があります。また、Uniface CD は手元
6
Uniface インストール/構成ガイド(iSeries 版)
にあるものの、iSeries 自体の CD ROM ドライブにアクセスできない場合にも、この処理を実行す
る必要があります。
配布ファイルは / ルート ファイル システムまたは /QopenSys ファイル システムに抽出すること
をお勧めします。
共有からインストールを実行するには、AS400INS プログラムを復元して起動する必要がありま
す。
配布ファイルを抽出するには、以下の手順を実行します。
1
iSeries Navigator(またはクライアント アクセス)を使用して iSeries に共有を作成するか、
または既存の共有を使用します。
2
この共有を Windows PC にドライブとしてマップします。
3
自己展開型の実行可能ファイルを使用している場合は、PC 上でそのファイルを実行して、
iSeries IFS に Uniface 配布ファイルを抽出します。
4
Uniface CD が手元にあるものの、CD ROM ドライブにアクセスできない場合は、エクスプ
ローラのドラッグ & ドロップを使用するか、または MS-DOS コマンドの xcopy を使用して、
マップしたドライブに CD の内容をまるごとコピーします。
5
IFS で Uniface 配布ファイルを抽出した正確な場所を覚えておいてください。この情報は、
Uniface インストーラの復元と実行に必要になります。
インストーラをライブラリ QTEMP に復元するには、以下の CL コマンドを実行します。
1
savefile をライブラリ QTEMP にコピーします。
CPYFRMSTMF FROMSTMF('/uniface/AS2/AS400INS.SVF')
TOMBR('/QSYS.LIB/QTEMP.LIB/INSTALL.FILE')
MBROPT(*REPLACE)
メモ:ここでは、IFS ディレクトリ /uniface に配布ファイルが抽出されているという前提で
説明します。別のディレクトリに抽出した場合は、CL コマンドの /uniface を抽出先のパス
に置き換えてください。
2
AS400INS プログラムとその表示ファイルをライブラリ QTEMP に復元します。
RSTOBJ OBJ(*ALL) SAVLIB(UNIFLIB) DEV(*SAVF)
OBJTYPE(*ALL) SAVF(QTEMP/INSTALL) RSTLIB(QTEMP)
これで savefile からインストーラ プログラムが抽出されます。
これで、DLM と Uniface をインストールできます。
第 1 章 インストールと構成
7
1.6 iSeries への DLM のインストール
Uniface では、ライセンス管理に Distributed License Management を使用します。この製品は
Uniface のインストール CD に入っています。また、電子配布によって提供されます。Uniface を
使う前に、DLM をインストールする必要があります。まず DLM をインストールしてライセンス
を設定してから、Uniface をインストールするという順序をお勧めします。
AS400INS はウィザードのようなインストーラで、画面から画面に移動しながらインストール プロ
セスが進みます。次の画面に進むには [Enter] を押し、前の画面に戻るには [F12] を押し、何もイ
ンストールしないでただちにインストーラを停止するには [F3] を押します。
DLM をインストールするには、以下の手順を実行します。
1
DLM のインストーラを起動します。
共有からインストールする場合は、以下のコマンドを入力します。
CALL PGM(QTEMP/AS400INS) PARM('src=/uniface/dlm')
CD から直接インストールする場合は、以下のコマンドを入力し、[Enter] を 2 回押します。
LODRUN
DEV(*OPT)
DIR('/dlm')
メモ:以下のコマンドでは、デフォルトの CD-ROM ドライブに *OPT からアクセスしていま
す。*OPT ではない場合は、実際のデバイス名(たとえば OPT01 など)を使用してください。
2
[Welcome] 画面で、[Enter] を押して次の画面に移動します。
3
DLM 製品と構成ファイルの保存先となるライブラリと IFS ディレクトリを指定します。
メモ:DLM 4.1 は現在、IFS ディレクトリがデフォルトの /.compuware の場合にのみ正しく
機能します。したがって、このデフォルトを変更しないでください。DLM の今後のリリース
で、この問題は修正される予定です。以降のセクションでは、ライブラリ名として DLM41、
IFS ディレクトリとして /.compuware を入力したことが前提になっています。
4
DLM コンポーネントを選択または選択解除します。
インストールするコンポーネントは 1 つだけなので、[Enter] を押してデフォルトを受け入れ
ます。
5
これまで指定した情報をレビューし、確認します。
[Enter] を押して DLM のインストールを開始します。
DLM プログラムとサービス プログラムが指定のライブラリにコピーされ、DLM 構成ファイ
ルが指定の IFS ディレクトリにコピーされます。
8
Uniface インストール/構成ガイド(iSeries 版)
6
有効なライセンスがない場合は、コンピュウェアに連絡して取得してください。Uniface 製品
の有効なライセンスをすでにお持ちの場合は、この手順をスキップできます。
その際、ライセンスが必要なマシンのホスト ID やシリアル番号などの情報をお尋ねする場合
があります。この情報は、DLM インストールの一部である DLMINFO プログラムを実行する
と、取得できます。
iSeries のコマンド行で以下のコマンドを入力します。
CHGCURLIB DLM41
CALL DLM41/DLMINFO
このプログラムで、バイト形式(ビッグ エンディアン)、ホスト名とドメイン名、TCP/IP アド
レス、ホスト ID(マシンのシリアル番号)が表示できます。
1.6.1 DLM ライセンスの構成
Uniface ライセンスは、TCP/IP でアクセス可能な iSeries または別のプラットフォームで動作する
DLM ライセンス サーバー経由で使用できます。また、ローカル ライセンス ファイルとして使用す
ることもできます。Uniface で使用するライセンスを構成するには、DLM に含まれている License
Administration Utility を使用します。このユーティリティでは、Uniface ライセンスに応じたラ
イセンス ファイルまたはライセンス サービスを特定できます。
◆
iSeries に DLM ライセンス サーバーが搭載されている場合は、そのサーバーを起動し(または
実行中であることを確認し)、License Administration Utility DLMCV を使用してライセンス
を構成します。
◆
iSeries 以外のプラットフォームにライセンス サーバーがある場合、そのプラットフォーム用
の DLM サービスのインストールと構成については、『DLM License Guide』を参照してくだ
さい。
◆
ライセンス サーバーではなくローカル ライセンス ファイルを使用する場合は、Uniface ユー
ザーが読み取り可能な IFS 内の場所に、そのファイルがあることを確認します。そのファイル
はテキストファイル(XML)なので、FTP を使用して Ascii モードで iSeries に転送可能で
す。次に、License Administration Utility を使用して、ライセンスを構成します。
DLM ライセンス サーバーを起動するには、以下の手順を実行します。
1
DLM インストールの IFS サブディレクトリ cpwr/license、つまり /.compuware/cpwr/
license に、目的のサービスに必要なライセンス ファイルをすべて転送します。
これは、Ascii モードで FTP を介して行うことができます(ライセンス ファイルはテキストの
XML ファイルです)。
2
以下のコマンドを入力して、ライセンス サービスを開始します。
SBMJOB CMD(CALL PGM(DLM41/CPWR)
第 1 章 インストールと構成
9
JOB(CPWR)
CURLIB(DLM41)
ALWMLTTHD(*YES)
3
WRKACTJOB を使用すると、ライセンス サービスが実行されているかどうかを確認できま
す。
CPWR というジョブがサブシステム QBATCH の下に表示されます。
iSeries で License Administration Utility を使用するには、以下の手順を実行します。
1
以下のコマンドを入力して、License Administration Utility を開始します。
CHGCURLIB DLM41
CALL DLM41/DLMCV
以下のような画面が表示されます。
---DLMCV Main--Client
License Service
Hit enter for previous menu or enter a command.
dlmcv>
2
Uniface を DLM クライアントとして構成するため、c と入力し、[Enter] を押して [Client] サ
ブメニューを選択します。
以下のサブメニューが表示されます。
---Client command list--Applications
Broadcast
License path
Pools
Server loading
Timeout
Who
Verify
Hit enter for previous menu or enter a command.
Enter '?' for help.
dlmcv>
3
l と入力し、[Enter] を押して [License path] サブメニューを選択します。
以下の画面が表示されます。
Current setting(s):
not set
10
Uniface インストール/構成ガイド(iSeries 版)
---[License path] Command list--Add
Remove
Hit enter for previous menu or enter a command.
dlmcv>
(not set という設定は、ライセンス ファイルもライセンス サーバーもまだ設定されていないこ
とを示します)
「
a」と入力し、[Enter] を押して、ライセンス ファイルまたはライセンス サービスを Add しま
す。
◇
ローカル ライセンス ファイルをお持ちの場合は、その絶対パスを入力し、[Enter] を押し
ます。
◇
ライセンス サービスでライセンスを提供する場合は、リスンするポート番号、@、マシン
のホスト名または IP アドレスの順に入力します。以下に例を示します。
[email protected]
[Enter] を押します(not set ではなく、入力したパスが表示されます)。
4
もう一度 [Enter] を押して、前のメニューに戻ります。
5
v と入力して [Verify] を選択します。
現在の設定でライセンス チェックアウトが機能するかどうかをテストできます。
ライセンスが検証できなければ Uniface もライセンスをチェックアウトできないため、この検
証は重要です。通常の iSeries インストールでは、ライセンス機能の USRVDB2 または
UDB2、およびバージョン 09.01 を検証できます。すべてが正しく動作すると、以下のような
画面が表示されます。
This feature is working properly
source
feature/app
requested version
actual
version
expires
type
:
:
:
:
:
:
[email protected]
USRVDB2
09.01
09.01
40 days
concurrent
第 1 章 インストールと構成
11
1.7 iSeries での Uniface のインストール
前提条件 : 新バージョンの Uniface をこれまでとは別のライブラリにインストールするか、また
は先に旧バージョンのインストールを削除します。既存のインストールを修復する必要がある場合
は、「既存のインストール上へのインストール」を参照してください。
一連の画面で Uniface インストーラ(AS400INS)が必要とする情報を入力するように求められま
す。次の画面に進むには [Enter] を押し、前の画面に戻るには [F12] を押し、何もインストールし
ないでただちにインストーラを停止するには [F3] を押します。
Uniface をインストールするには、以下の手順を実行します。
1
Uniface のインストーラを起動します。
共有からインストールする場合は、以下のコマンドを入力します。
CALL PGM(QTEMP/AS400INS) PARM('src=/uniface/AS2')
CD から直接インストールする場合は、以下のコマンドを入力し、[Enter] を 2 回押します。
LODRUN DEV(*OPT)
メモ:以下のコマンドでは、デフォルトの CD-ROM ドライブに *OPT からアクセスしていま
す。*OPT ではない場合は、実際のデバイス名(たとえば OPT01 など)を使用してください。
2
[Welcome] 画面で、[Enter] を押して次の画面に移動します。
3
Uniface 製品のインストール先となるライブラリと、その他のファイルのインストール先とな
る IFS ディレクトリをそれぞれ指定します。
[Enter] を押してデフォルト値のままとするか、またはここでデフォルト値を変更します。
ディレクトリ名が絶対パスでない場合(つまり、スラッシュ / で始まっていない場合)、
[Enter] を押すと、同じディレクトリの前にカレント ディレクトリが付加されて、同じ画面が
もう一度表示されます(現行ディレクトリは通常、ユーザー プロファイルで指定したホーム
ディレクトリです。ホーム ディレクトリを指定していない場合は、ルート ディレクトリ / が
通常、カレント ディレクトリです)。
4
もう一度 [Enter] を押して、次の画面に進みます。
インストーラによって、ライブラリとディレクトリの作成が試みられます。どちらかの作成に
失敗すると、上記の画面に戻り、下のステータス行にエラー メッセージが表示されます。ここ
で値を変更して、再試行できます。
5
12
インストールするコンポーネントを選択します。
Uniface インストール/構成ガイド(iSeries 版)
選択したコンポーネントの前には 1 が表示されます。[Enter] を押してデフォルトの選択のま
まとすることをお勧めします。
6
使用する言語の前に 1 と入力してその言語を選択し、[Enter] を押します。
Uniface がサポートするコード ページの一覧が表示されます。[PageDown] キーと [PageUp]
キー(または [RollUp] と [RollDown])を使用すると、表示される言語をスクロールできます。
実行するジョブの CCSID がサポートされるコード ページに入っている場合は、すでに 1 が付
けられています。そうでない場合、デフォルトは米国英語の CCSID 37 です。
ここで選択した言語は、インストーラで生成されるアサインメント ファイルに反映される他、
UROUTER ジョブと USERVER ジョブの CCSID にも反映されます。
言語を選択しなかったり、複数の言語を選択したり、1 以外の文字を入力したりした場合は、
エラー メッセージが表示され、この画面が表示されたままになります。
7
サブシステムとジョブ待ち行列の名前を指定し、[Enter] を押します。
デフォルト名が入力されています。前に指定したライブラリ名は、サブシステム記述とジョブ
待ち行列が作成されるライブラリとして表示されます。
このライブラリ名は変更しないことをお勧めします。サブシステムの名前は、システムに既存
のサブシステムと競合しない名前で、通常のファイル命名規則に沿っているならば、自由に付
けられます。
サブシステムを作成するのではなく、QBATCH または別の既存のサブシステムを使用する場
合は、[F2] を押します。
8
インストーラで作成するジョブ記述と、UROUTER ジョブの所有者であるユーザーのプロ
ファイル名を指定し、[Enter] を押します。
デフォルトでは、現在のユーザー名が入力されています。ただし、UROUTER ジョブの所有
者として UNIFSID を使用することをお勧めします。サブシステムが作成されます。これには
UROUTER を起動する自動開始ジョブが含まれます。ここで入力するユーザー名がこのジョ
ブの所有者になり、すでに存在しているはずです。
ジョブ待ち行列フィールドは、[F2] を押していなければ前の画面と同じです。[Enter] ではな
く [F2] を押した場合は、画面が若干異なります。デフォルト値は QBATCH と *LIBL であり、
どちらもほとんどの iSeries システムにすでに存在しています。サブシステムは作成されず、
ここで入力した既存のジョブ待ち行列とジョブ記述が使用されます。
9
UROUTER を起動するパラメータ、つまりサブシステムを開始するか、または STARTUP を
実行するパラメータを指定します。
デフォルトのパラメータは TCP:+13001 です。この場合、UROUTER はポート 13001 でリス
ンを開始します。UROUTER が取るパラメータ(コマンド ライン スイッチ)については、
第 1 章 インストールと構成
13
「実行可能ファイルとスイッチ」を参照してください。たとえば、/asn= を使用すると、
UROUTER では ASN ファイルのメンバ UROUTER とは異なるアサインメント ファイルが使
用されます。
パラメータの編集を終了したら、[Enter] を押します。
10 DLM をインストールしたライブラリを指定します。
この情報は、あとでインストーラによって作成される UROUTER スタートアップ プログラム
で、ライブラリ リストを正しく設定するために必要です。まだ DLM をインストールしていな
い場合、あとで DLM をインストールする際には、必ずここで指定したライブラリにインス
トールしてください。デフォルトは DLM41 で、DLM インストーラ用のデフォルトでもあり
ます。
11 次の画面で、これまで指定した情報をレビューし、確認します。
[PageDown](または RollUP)キーを使用して、下にスクロールできます。
この時点では、インストール ライブラリとインストール ディレクトリが作成されただけであ
り、まだ何もインストールされていません。ただちに停止するには [F3] を押し、インストール
を続けるには [Enter] を押します。
インストール プログラムが作成され、必要なファイルがコピーされ、デフォルトのアサインメ
ント ファイルが作成されます。実行中、画面に進行状態を示すメッセージが表示され、IFS の
カレント ディレクトリにある install.err ファイルにメッセージが書き込まれます。
メモ:install.err ファイルは、その名前にもかかわらず、エラー メッセージだけでなく、
進行状態のメッセージも記録されるログ ファイルです。
[Copy files] の手順が最も時間がかかります。他にタスクがまったく動作していないマシンで
も、10 分程度かかることがあります。インストールが正常に終了すると、インストーラが進め
てきた各ステップに続けて [Done] という文字が表示されます。途中で問題が起きた場合は、
install.err ファイルで詳細を確認してください。
インストールしたオブジェクトについては、「インストール内容」を参照してください。
1.7.1 既存のインストール上へのインストール
旧バージョンのインストール上に Uniface をインストールすることもできますが、お勧めしませ
ん。別のライブラリにインストールするか、または先に旧バージョンをアンインストールしてくだ
さい。
14
Uniface インストール/構成ガイド(iSeries 版)
けれども、既存のインストールの上に同じバージョンのインストールが必要になる場合もありま
す。たとえば、オブジェクトが誤って削除されたり壊れてしまったときなどです。
既存のインストール上にインストールするには、以下の手順を実行します。
1
サブシステム自体(作成した場合)も含め、Uniface プロセス(UROUTER など)をすべて停
止します。
2
インストーラを実行します。
前のインストールの上からインストールすると、以下のようになります。
◇
サブシステム、クラス、ジョブ待ち行列、ジョブ記述がすべて再作成されて、古いものと
名前が同じ場合は置き換えられます。これらの名前が異なる場合は、古いものもそのまま
残ります。
◇
既存のアサインメント ファイルが BAK ファイルに移されたあと、新しいアサインメント
ファイルが生成されます。
3
インストーラの終了後、DSPJOBLOG を使用して、エラー メッセージがないかジョブ ログを
チェックします。
1.7.2 インストール内容
インストールの完了後、以下のオブジェクトが存在している必要があります。
◆
サブシステム記述(サブシステムの作成を選択した場合)
◆
ジョブ待ち行列(サブシステムが作成された場合)
◆
ジョブ記述(サブシステムが作成された場合)
◆
クラス(サブシステムが作成された場合)
◆
STARTUP プログラム
◆
STARTUP ソース ファイル
◆
QPRINT プリンタ ファイル
◆
*PGM オブジェクトと *SRVPGM オブジェクトのリスト
◆
Uniface 4GL オブジェクトとアサインメント ファイルを含むファイルのリスト
完全なリストについては、以下の「オブジェクトの完全なリスト」を参照してください。
STARTUP プログラム
サブシステムには、自動開始エントリとして、インストーラが作成したジョブ待ち行列を使用する
STARTUP があります。STARTUP プログラムは STARTUP ソース ファイルを使ってコンパイル
されており、以下のような CL メンバ STARTUP があります。
第 1 章 インストールと構成
15
PGM
SBMJOB CMD(CALL PGM(UNIFxxxx/UROUTER) +
PARM('TCP:+13001')) +
JOB(UROUTER) +
JOBD(UNIFxxxx/UNIFxxxx) +
OUTQ(*JOBD) +
RTGDTA(UNIFACE) +
CURLIB(UNIFxxxx) +
CCSID(37) +
ALWMLTTHD(*YES)
ENDPGM
メモ:'TCP:+13001' の単一引用符、コロン、プラス記号は省略できません。
メモ:ALWMLTTHD(*YES) オプションは、ジョブ記述にも指定されています。したがって、
ALWMLTTHD(*JOBD) も有効です。UROUTER はマルチスレッドであるため、マルチスレッ
ドを許可する必要があります。
オブジェクトの完全なリスト
表 1-2. Uniface が使用する製品オブジェクト
16
オブジェクト
タイプ
説明
UNIFxxxx
*JOBQ
Uniface ジョブ待ち行列1
UNIFxxxx
*JOBD
Uniface ジョブ記述
UNIFxxxx
*CLS
UROUTER クラス
UNIFxxxx
*SBSD
UROUTER サブシステム記述
IDF
*PGM
Uniface 対話式開発機能
PATHSCRAMB
*PGM
Uniface パス スクランブラ
STARTUP
*PGM
UROUTER 自動開始プログラム
UNIFACE
*PGM
Uniface バッチ
UROUTER
*PGM
Uniface ルーター
Uniface インストール/構成ガイド(iSeries 版)
表 1-2. Uniface が使用する製品オブジェクト
オブジェクト
タイプ
説明
USERVER
*PGM
Uniface サーバー
UDEPLOY
*PGM
Uniface デプロイメント ユーティリティ
IRTL
*SRVPGM
Uniface コンパイラ ライブラリ
UCALL
*SRVPGM
Uniface ブートストラップ
UDB230
*SRVPGM
Uniface DB2(3.0)コネクタ
UIBM
*SRVPGM
Uniface コードページ ライブラリ
UIMG
*SRVPGM
Uniface イメージ ライブラリ
ULIB
*SRVPGM
Uniface ベース ランタイム ライブラリ
UMWPSV10
*SRVPGM
Uniface ミドルウェア コネクタ
UPACK
*SRVPGM
Uniface ユーザー定義の Y および Z パッキング コード
UROUT
*SRVPGM
Uniface ルーター ランタイム ライブラリ
URTL
*SRVPGM
Uniface ランタイム ライブラリ
USEQ10
*SRVPGM
Uniface SEQ(1.0)コネクタ
USERV
*SRVPGM
Uniface サーバー ランタイム ライブラリ
UTCP10
*SRVPGM
Uniface TCP(1.0)コネクタ
ULAT
*SRVPGM
Uniface Latin コードページ
UXML
*SRVPGM
Uniface XML
UWS
*SRVPGM
Uniface Web サービス コールイン
WSCISAMPLE
*SRVPGM
Uniface Web サービス コールイン API サンプル
XERCES210
*SRVPGM
XERCES XML パーサー バージョン 2.1.0
YRTL
*SRVPGM
Uniface ランタイム PROC ライブラリ
ZSECDRV
*SRVPGM
Uniface セキュリティ ドライバ
APS
*FILE
Uniface スタートアップ シェル
ASN
*FILE
Uniface アサインメント ファイル
第 1 章 インストールと構成
17
表 1-2. Uniface が使用する製品オブジェクト
オブジェクト
タイプ
説明
DIS
*FILE
Uniface 4GL 配布ファイル
DOL
*FILE
Uniface 配布オブジェクト ライブラリ
DSC
*FILE
Uniface 記述子ファイル
FRM
*FILE
Uniface フォーム
H
*FILE
Uniface 3GL 開発用ヘッダ ファイル
JSS
*FILE
Uniface Java スクリプト
LOG
*FILE
UROUTER および USERVER のログ ファイル
QPRINT
*FILE
Uniface プリンタ ファイル
SQL
*FILE
Uniface DB2 SQL スクリプト
STARTUP
*FILE
STARTUP プログラムの CL ソース ファイル
SVC
*FILE
Uniface サービス
TRX
*FILE
Uniface エクスポート ファイル
URR
*FILE
Uniface ランタイム リポジトリ ファイル
USP
*FILE
Uniface サーバー ページ
LICENSE
*FILE
XERCES ライセンス情報
1. これらのオブジェクトは、インストール時にサブシステムの作成を選択した場合にだけ、作成さ
れます。
1.8 Uniface ランタイム環境
Uniface ランタイム環境には、実行可能ファイル、サーバー、ドライバなどが含まれており、ほぼ
どのプラットフォームでもデプロイメント環境でも Uniface を実行できます。また、ランタイム環
境に Uniface アプリケーションを配置するためのツールも含まれています。
ランタイム環境は、多数のプラットフォームとデータベースからなるデプロイメント環境で動作す
るように構成できます。Uniface がサポートするプラットフォームとデータベースの詳細について
は、FrontLine Uniface (frontline.compuware.com/products/uf/default.asp) の Platform
Availability (frontline.compuware.com/products/uf/tech/15616.asp) を参照してください。
18
Uniface インストール/構成ガイド(iSeries 版)
表 1-3. Uniface ランタイム環境
製品コンポーネント
説明
インタプリタ
コンパイルされたアプリケーションのコンポーネントとライブラ
リを解釈して実行するプラットフォーム固有のプロセス
Uniface ランタイム リポジトリ
すべてのランタイム オブジェクトの定義が含まれている、
Uniface ランタイム環境のデータベース。通常、これは Uniface
ランタイム エンジンと同じサーバーに保存されているコンパイル
済みファイル(URR)です。また、DBMS として利用することも
できます。
Uniface サーバー
Uniface クライアントによるリモート リソースへのアクセスやリ
モート コンポーネントの実行を可能にするサーバーベースのプロ
セス
Uniface ルーター
Uniface サーバーの起動と停止、負荷分散、プロセス間のメッ
セージ処理を含む、Uniface サーバーを管理するマルチスレッド
プロセス
Uniface ルーター モニタ
Uniface ルーターのパフォーマンスの監視と微調整に使用する
Uniface アプリケーション
データベース コネクタ
Uniface と各種 DBMS 間の接続を処理するドライバ。Uniface で
は、サポートされる DBMS ごとに固有のコネクタが用意されて
います。
Uniface Web アプリケーション サーバー
(WASV)
Web 上での Uniface アプリケーションの配置を可能にするデプ
ロイメント エンジン。これにより、Jakarta Tomcat Web アプリ
ケーション サーバーと Uniface サーバー、Uniface ルーター、
WRD が統合されます。
Uniface SOAP リクエスト ディスパッチャ
(SRD)
SOAP 要求と WSDL 要求を仲介する役割を果たす Java サーブ
レット
UNIFACE Web リクエスト ディスパッ
チャ(WRD)
Web サーバーと Uniface ルーター間の要求の仲介と接続の維持の
役割を果たす Java サーブレット
Uniface JTi(Java シンクライアント イン
タフェース)
インターネットに接続するコンピュータに Uniface アプリケー
ションを動的に配布する Web コンピューティングのプラット
フォーム
Uniface ランタイム マネージャ(URMA)
ランタイム環境での Uniface アプリケーションの保守に使用する
プログラム
第 1 章 インストールと構成
19
1.8.1 Uniface サーバー
Uniface サーバーは、Uniface クライアントがリモート リソースにアクセスしたり、リモート コン
ポーネントを実行したりすることを可能にするサーバー ベースのプロセスです。クライアントと
サーバー間の通信は、すべて Uniface ルーターが処理します。
Uniface サーバーは、アプリケーション サーバー、データ サーバー、ファイル サーバーとして機
能します。デフォルトでは、Uniface サーバーのロールは以下のとおりです。
◆
Uniface 仮想マシン — リモート Uniface コンポーネント(サービスとレポート)を実行しま
す。
◆
リモート アプリケーション呼び出し — アプリケーション インテグレーション コネクタ
(CICS、COM+、CORBA、汎用 3GL など)を通じて、リモート コンポーネントを実行しま
す。
◆
リモート データ アクセス ― アプリケーション用のデータベース データへのアクセスと、
サーバー ベースのアプリケーション ファイルに対する読み書きを実行します。
Uniface サーバーは、それ自体と同じホスト上にあるデータベース、ファイル、またはアプリケー
ション コンポーネントにアクセスします。異なるホスト上のデータやサービスへアクセスする必要
がある場合は、Uniface ルーターを通じて、複数の Uniface サーバーを接続します。
デフォルトでは、Uniface サーバーは共有サーバーであり、複数クライアントからの要求を処理で
きます。Uniface ルーターは、クライアントと Uniface サーバー(複数可)の間の接続を確立しま
す。また、クライアントから Uniface サーバーへ、排他的に接続することも可能です。この場合、
接続を確立するために Uniface ルーターが必要ですが、接続の確立後は Uniface ルーターは不要に
なります。
メモ:開発環境では、共有サーバーでアプリケーション エンティティを変更しないことをお勧
めします。エンティティの定義の追加と変更が終わるまで排他的サーバーを使用し(/ex ス
イッチを使用)、その後は共有サーバーを使用します。
ロール
Uniface サーバーにはデフォルトで複数のロールがあります。ただし、Uniface サーバーを、1 つ
のロールを果たす専用サーバーとして使用することもできます。この場合、必要なサーバー ロール
をクライアントのアサインメント ファイルで以下のように指定します。
20
◆
ORA、MSS、SOL — データベース サーバー(Oracle、Microsoft SQL Server、SOLID)
◆
FIL — ファイル サーバー
Uniface インストール/構成ガイド(iSeries 版)
◆
SRU — Uniface 仮想マシンとして動作
◆
S3C — 3GL コンポーネントを実行
UST
Uniface サーバー タイプ(UST)は、特定の Uniface サーバーとその環境の名前です。これは、
urouter.asn ファイルの [SERVERS] セクションで定義します。一度定義すると、アサインメン
トによって、クライアントのデータベース要求、ファイル、コンポーネント、アプリケーション
を、Uniface ルーターを介して適切な Uniface サーバーに送信できます。
Uniface サーバーの起動
サーバーは、以下の複数の方法で起動できます。
◆
クライアント接続が発生したときに、Uniface ルーターによってサーバーが起動されます。
◆
Uniface ルーターの起動時に、サーバーを事前起動できます。
◆
サーバーを手動で起動し、Uniface ルーターに接続できるようにします。
◆
Uniface ルーター モニタを使用して、サーバーを手動で起動します。
1.8.2 Uniface ルーター
Uniface ルーターは、配置されたアプリケーションに対して複数のタスクを実行する、マルチス
レッド プロセスです。Uniface ルーターは、Uniface クライアント アプリケーションと、クライア
ントの要求を実行する Uniface アプリケーション サーバーの間に配置されます。
Uniface ルーターは以下のタスクを実行します。
◆
Uniface アプリケーション サーバー プロセスの起動と終了 ― Uniface ルーターは、クライア
ントの要求に応じて、複数のクライアントによって使用可能な、Uniface サーバーを起動でき
ます。Uniface ルーターは、Uniface ルーターの起動時に、自動的にサーバーの事前起動
(Uniface サーバー インスタンス)を行うこともできます。
◆
負荷分散 ― Uniface ルーターは、起動可能な Uniface サーバーの数を判定し、個々のクライ
アント要求を、特定のサーバーに送信します。Uniface ルーターは、アプリケーション全体の
負荷分散を受け持ちます。
◆
メッセージの送受信 ― Uniface ルーターはさまざまな Uniface プロセス間でメッセージの送
受信を行います。
第 1 章 インストールと構成
21
複数のスレッド
Uniface ルーターは、起動時、最大 4 つの指定ネットワークに対しネットワーク リスン スレッドを
開始します。異なるネットワーク プロトコル(最大 4 種類)を開始することもできますし、同じプ
ロトコルを異なるポート番号で開始することもできますし、異なるプロトコルを異なるポート番号
で開始することもできます。サービスをサポートする Microsoft Windows プラットフォームでは、
複数の Uniface ルーターを独立したサービスとしてインストールできます。詳細については、
Uniface ライブラリの「Uniface ルーターのマルチスレッド」を参照してください。
パフォーマンス
Uniface ルーターにはユーザー インタフェースが用意されていないため、パフォーマンスに関する
情報は表示されません。パフォーマンスに関する情報は、[Uniface Router Monitor] に表示されま
す。このユーティリティには Uniface ルーターに関する情報が表示され、ここからパフォーマンス
を調整することができます。
障害回復
何らかの理由で Uniface ルーターに障害が発生した場合、自動的に再起動が行われます。
Microsoft Windows では、Uniface ルーターはサービスとして実行され、自動的に再起動するよう
に構成されています。60 秒以内に再び停止した場合は、30 秒後に再起動します。60 秒以内に再び
クラッシュすると、再起動は行われません。
Unix では、クラッシュからの回復はスクリプト ファイル urouter.sh によって制御されます。こ
のファイルでは、常に、Uniface ルーターを再起動します。Uniface ルーターに障害が発生すると、
スクリプトは最後の 3 つのコア ダンプをコピーします。
1.8.3 Uniface Web アプリケーション サーバー
Uniface Web アプリケーション サーバーは、Web サーバーとサーブレット エンジンと共に、
Uniface Web アプリケーションの配置を可能にします。
Uniface Web アプリケーション サーバー(WASV)は、以下のコンポーネントで構成されていま
す。
22
◆
Uniface サーバー
◆
Uniface ルーター
◆
Uniface Web リクエスト ディスパッチャ Java サーブレット
Uniface インストール/構成ガイド(iSeries 版)
サーブレット エンジンと Web サーバー
Uniface Web アプリケーションを配置するには、Web サーバーで動作するサーブレット エンジン
に WASV を統合する必要があります。Uniface では、アプリケーションのテストとデバッグを行う
環境が整うように、デフォルトの Web サーバーとサーブレット エンジンとして Tomcat がインス
トールされます。
デプロイメント環境には、Apache Web Server、Netscape Enterprise Server、Microsoft Internet
Information Server MS-IIS など、Tomcat 以外の Web サーバーも選択できます。
Web サーバーを選択するときは、Web サーバーで動作するサーブレット エンジンも含まれている
か、インストールされることを確認します。たとえば、MS-IIS を選択する場合は、MS-IIS で動作
する Jrun などのサーブレット エンジンをインストールする必要があります。
Tomcat 以外の Web サーバーとサーブレット エンジンを選択する場合、Uniface WASV がサーブ
レット エンジンに統合されるように設定する必要があります。
1.8.4 Uniface Web リクエスト ディスパッチャ
Uniface Web リクエスト ディスパッチャ(WRD)は、Web サーバーと Uniface ルーター間の要求
の仲介と接続の維持の役割を果たす Java サーブレットです。WRD は Uniface ルーターを通じて
Uniface サーバーと通信します。
WRD Java サーブレットは Java™ サーブレット API 2.1 をサポートしています。Java サーブレッ
ト API をサポートするすべての Web サーバーに対して簡単に設定できます。Java はプラット
フォームに依存しない言語なので、WRD Java サーブレットを使用すると、Uniface Web アプリ
ケーションを任意のプラットフォームにデプロイできます。WRD サーブレットは、SOAP リクエ
スト ディスパッチャ(SRD)サーブレットと共に、WRD Java アーカイブ ファイル
wrdxxyy.jar の一部として配布されます。
Uniface Web リクエスト ディスパッチャは、Web サーバーを通じてクライアント ブラウザから要
求を受信し、その要求をミドルウェア モジュールを通じて Uniface にディスパッチします。
Uniface ルーターへの接続が確立され、Uniface ルーターによって Uniface サーバーに要求が割り
当てられて、その要求が Uniface サーバーで処理されます。
WRD の内部構造には、Uniface ルーターを通じて Uniface サーバーへの接続を確立する Uniface
TCP/IP 用のミドルウェア モジュールが含まれています。
サーブレット エンジン
一部の Web サーバーはサーブレットを直接起動できないため、それらのサーバーにはサーブレッ
ト エンジンを構成する必要があります。Uniface Web リクエスト ディスパッチャを Web サーバー
に統合するには、WRD のサーブレット エンジン(Tomcat など)を構成する必要があります。
第 1 章 インストールと構成
23
サーブレット エンジンによって WRD サーブレット インスタンスのプールが処理され、通常はそ
の数が制限されます。すべてのサーブレット インスタンスが、Uniface サーバーのプールを処理す
る Uniface ルーターと通信します。
24
Uniface インストール/構成ガイド(iSeries 版)
第 2 章 iSeries への Uniface の
インストール
2.1
iSeries でのファイル アクセス
iSeries でのファイル アクセスは、タイプが ANY または FIL の Uniface サーバー(USERVER)
経由で行われます。
クライアントのアサインメント ファイルで、フォーム、サービス、テキスト ファイルなどのファ
イルを iSeries の ANY USERVER や FIL USERVER にリダイレクトできます。
以下に例を示します。
[PATHS]
$FIL = TCP:Machine+Port|User|Password + FIL:||
[FILES]
*.frm $FIL:*.frm
*.aps $FIL:MYLIB/*.aps
*.rpt $FIL:IFS:*.rpt
*.svc $FIL:IFS:/home/somewhere/*.svc
このアサインメント ファイルにより、.frm、.aps、.rpt、.svc の各ファイルが iSeries 上に置
かれますが、以下のようにそれぞれの方法が異なります。
◆
.frm ファイルは、インストール ライブラリ UNIFxxxx にあるファイル FRM のメンバになりま
す。
◆
.aps ファイルは、ライブラリ MYLIB にあるファイル APS のメンバになります。
◆
.rpt ファイルは、USERVER のカレント ディレクトリ、つまり USERVER を所有するユー
◆
.svc ファイルも、絶対パス /home/somewhere/*.svc にある IFS に置かれます。
ザーのホーム ディレクトリにある IFS(統合ファイル システム)に置かれます。
IDF のアサインメント ファイルでこれらのパスを設定すると、フォーム、サービス、サーバー
ページ、DOL ファイル、URR ファイルなどすべてを iSeries 上で直接コンパイルしたり生成した
りできます。そのあと iSeries 上の USERVER は、アサインメント ファイルの適切なリダイレク
25
ションによって、サービスやサーバー ページを実行するファイルや、生成された DOL ファイルや
URR ファイルを使用できます。
メモ:Uniface では、ファイル タイプの区別にファイル拡張子が使われます。IFS を使用しな
い場合は、拡張子がファイル名になり、拡張子のないファイル名がメンバ名になります。たと
えば、mylib/userver.asn は、ライブラリ MYLIB のファイル ASN のメンバ USERVER で
あることを示しています。これは、通常の iSeries の表記(mylib/asn.userver)とは異なっ
ています。この表記方法を使用するのは、Uniface の前バージョンや他のプラットフォームとの
互換性を確保するためです。
HTML や JavaScript ファイルなどのテキスト ファイルの場合は、IFS で保存することをお勧めし
ます。ライブラリ内のファイルには固定の最大レコード長がありますが、IFS ファイルにはありま
せん。ライブラリ システムでファイル メンバのファイルを保存すると、ファイルのレコード長よ
り長いテキスト行を書き込んでしまった場合に、その行が 2 行に分割されて、ファイルをあとで使
用するときにエラーになる可能性があります。
メモ:Uniface はマルチスレッドです。したがって、Uniface はスレッドセーフな IFS ファイル
システムだけをサポートします。スレッドセーフではないファイル システム上のファイルにア
クセスすると、予期しないエラーが起きることがあるため、サポートされていません(/ ルート
ファイル システムと /QopenSys はスレッドセーフです)。
2.2 iSeries での Uniface の構成
Uniface を構成するには、iSeries 上でデータベースとファイルを見つけてアクセスできるように、
Uniface ルーター、Uniface サーバー、およびクライアント アプリケーションのアサインメント
ファイルを編集する必要があります。
インストール時に、以下のアサインメント ファイル メンバが作成されます。
◆
DBMS — DBMS コネクタと場所を指定するアサインメント ファイル メンバ。
◆
UROUTER — Uniface ルーターのアサインメント ファイル メンバ。さまざまなパラメータで
Uniface サーバーを指定するサーバー名(UST)宣言が含まれています。
◆
USYS — グローバルなクライアント アサインメント ファイル メンバ。ローカルに割り当てら
れていないオブジェクトに関してどのクライアント アプリケーションでも使用される設定が含
まれています。
26
Uniface インストール/構成ガイド(iSeries 版)
◆
WASV — Uniface Web アプリケーション サーバーのクライアント アサインメント ファイル
メンバ。
◆
UDEPLOY — Uniface デプロイメント ユーティリティのクライアント アサインメント ファイ
ル メンバ。
Uniface を構成するには、以下の手順を実行します。
1
データを保存したりデータを取得したりできるコレクションが存在することを確認します。
コレクションはライブラリの 1 つで、DB2 カタログ テーブル、QSQJRN というジャーナル、
QSQJRNxxxx という 1 つまたは複数のジャーナル レシーバ(xxxx は 0001 から始まる数字)
が含まれます。SQL によってコレクション内にテーブルが作成され、ここにビジネス データ
が保持されます。
データがあるコレクションがすでに存在していれば、コレクションとして使用できます。存在
しない場合は、新たにコレクションを作成します。そのためには、SQL ステートメント
create collectionLibraryName を使用します。
2
Uniface で使用するリレーショナル データベースのローカル ディレクトリ エントリの名前を
取得します。
この名前を確認するには、コマンド WRKRDBDIRE を入力して、システムが認識しているリ
レーショナル データベースをすべて表示します。Remote Location に *LOCAL があるものが、
必要な名前です。
たとえば、以下のような行があるとします。
_ MY_AS400 *LOCAL Local Default Database
この場合、MY_AS400 が必要な名前です。
3
ローカル データベース エントリがない場合は作成します。
WRKRDBDIRE を使用し、[Option] カラムの先頭行に 1 と入力し、ローカル リレーショナル
データベースの名前を入力します。次に、[Enter] を押します。
4
正しい DBMS コネクタと場所を指定するようにメンバ DBMS を変更します。
メンバ DBMS には以下の設定が含まれています(DB2 U3.0 コネクタを使用するとします)。
[DRIVER_SETTINGS]
DB2 U3.0
USYS$DB2_PARAMS segmented fields : off
[PATHS]
; In the DB2 path below, replace RDBDIRE by the
; name of the local relational database.
; Use WRKRDBDIRE to obtain this name.
; Also replace LIBRARY with the name of the
第 2 章 iSeries への Uniface のインストール
27
; collection that the userver should use by default.
; Specify a username and password if you need the
; DB2 U3.0 connector to run in Server mode, otherwise
; it runs in Normal mode.
; See the DB2 Connector documentation
; for more information about Server mode.
$DB2 = DB2:RDBDIRE:LIBRARY||
$SYS $DB2
$UUU $SYS
$IDF $SYS
$DEF $SYS
$DB2 割り当てでは、RDBDIRE と LIBRARY を適切なリレーショナル データベース ディレクトリ
エントリとコレクション名に置き換えます。
メモ:DB2 に続く最初のコロン、データベース ディレクトリ名の最後にあるコロン、および縦
線を削除しないように注意してください。
詳細については、「iSeries での DB2 データベース アクセスの構成」を参照してください。
5
UROUTER アサインメント ファイル メンバには、さまざまなパラメータで Uniface サーバー
を起動するのに使用できる UST を指定します。
詳細については、「iSeries での Uniface ルーターの構成」を参照してください。
6
クライアント アサインメント ファイル メンバには、Uniface サーバー コネクタ パスを定義し
ます。[PATHS] セクションには、以下のシンタックスを使用して、Uniface サーバーへのパス
を指定します。
$DB2 TCP:iSeriesMachineName+PortNumber|User|Password {|UST} {/ex}
◇
iSeriesMachineName — iSeries や 127.0.0.1 など、ホストのネットワーク ノード名。
iSeriesMachineName のフォーマットによって、使用する TCP プロトコルのバージョン
が決まります。
◇
PortNumber — Uniface ルーターがリスンするポート番号。デフォルトは 13001 です。
詳細については、「TCP/IP 接続の確認」を参照してください。
◇
User と Password — V5R1 以降、ユーザー名とパスワードは大文字と小文字が区別され
ます。
◇
UST — 特定の Uniface サーバーの名前を指定する Uniface サーバー タイプ。Uniface ルー
ターのアサインメント ファイルの [SERVERS] セクションに、DATA や ASV などと宣言
します。UST を省略した場合は、デフォルトのサーバー タイプ DEFAULT が使用されま
す。
28
Uniface インストール/構成ガイド(iSeries 版)
◇
/ex—iSeriesMachineName で動作する Uniface サーバーがこのクライアント セッショ
ンに排他的になります。Uniface サーバーは他のクライアント セッションと共有されませ
ん。
コネクタ パスの定義の詳細については、「パ ス と コ ネ ク タ の割 り 当て 」を参照してくださ
い。
例
◆
以下の割り当てを行うと、Uniface ルーターは iSeries 上でタイプが ANY の共有 Uniface サー
バーを起動します。
$DB2 TCP:iSeries+13001|user|pass
このサーバーは、データベース サーバー、アプリケーション サーバー、またはファイル サー
バーとして機能できます。共有サーバーであるため、(ユーザーと UST が同じ)複数のクライ
アントが同じ Uniface サーバーを共有できる場合もあります。
◆
以下の割り当てを行うと、Uniface ルーターは iSeries 上でタイプが DB2 の共有 Uniface サー
バー(データベース サーバー)を起動します。
$DB2 TCP:iSeries+13001|user|pass + DB2:RDBDIRE:LIBRARY||
上記の RDBDIRE と LIBRARY は、サーバーにある DBMS のアサインメント ファイルと同じ値
にします。つまり、実際の値に置き換える必要があります。
◆
以下の割り当てを行うと、Uniface ルーターは Uniface ルーターのアサインメント ファイルの
wasv UST に指定されているパラメータを使用して、共有 Uniface サーバーを起動します。
$DB2 TCP:iSeries+13001|username|password|wasv
◆
以下の割り当てを行うと、Uniface ルーターはタイプが DB2 の排他 Uniface サーバーを起動し
ます。
$DB2 = TCP:iSeries+13001|user|pass -ex
メモ:sql PROC(または SQL ワークベンチ)を使用してデータベースに変更を加えるときに
は常に、共有 Uniface サーバーではなく、排他データベース サーバーまたは ANY サーバーを
使用することをお勧めします。
複数のクライアントが同じ DB2 サーバーまたは同じ ANY サーバーを使用して sql PROC を実
行すると(または SQL ワークベンチを使用すると)
、各クライアントのデータベース トランザ
クションが混乱します。このような事態が発生するのは、ユーザー名、パスワード、および
UST が同じ Uniface ルーターに複数のクライアントがログオンするときです。これが共有
Uniface サーバーです。
第 2 章 iSeries への Uniface のインストール
29
複数のクライアントが単一のトランザクションにあるため、他のクライアントが行ったコミッ
トされていない変更を読み取ったり、コミットやロールバックが複数のクライアントに適用さ
れたりする可能性があります。
2.3 iSeries での DB2 データベース アクセスの構成
iSeries で DB2 データベースにアクセスするには、DB2 U3.x DBMS コネクタを使用します。
iSeries の DB2 U3.x コネクタは、2 種類のモードで動作します。
◆
通常モード — どの iSeries ジョブでもデータベースへの同じ暗黙的接続を使用して、データ
ベース オブジェクトにアクセスします。このため、DB2:RDBDIRE:LIBRARY|| パスにはユー
ザー名もパスワードも不要です。この動作は、現在ではサポート対象外の DB2 U2.1 コネクタ
のオペレーションに似ています。
このような暗黙的接続が 1 つしかないため、このモードは並列トランザクションには向きませ
ん。コンポーネント プロパティ TRANSACTION=TRUE は機能しません。
サーバー モード — 並列トランザクション機能をサポートします。この機能を有効にするには、
◆
データベースへの接続を同時に複数確立して、それぞれの接続に独自のコミットメント制御を
持たせる必要があります。各接続とも、データベースにログオンして明示的に確立する必要が
あります。サーバー モードを使用するには、DB2: パスに以下のように有効なユーザー プロ
ファイル名とパスワードを指定する必要があります。
$DB2 = DB2:RDBDIRE:LIBRARY|User|Pass
サーバー モードでは、その名前のとおり iSeries 技術を使用します。
ユーザー名の有無によって、コネクタがサーバー モードになるか通常モードになるかが決まりま
す。
iSeries でのサーバー モードについての詳細は、IBM の Web サイトにあるサーバー モードに関す
る iSeries データベース マニュアルを参照してください。
DB2 データベース アクセスを構成するには、以下の手順を実行します。
1
DBMS アサインメント ファイル メンバを編集して、コネクタとパスを指定します。
[DRIVER_SETTINGS]
DB2 U3.0
[PATHS]
$DB2 = DB2:RDBDIRE:Library||
2
30
必要に応じてコネクタ設定を設定します。
Uniface インストール/構成ガイド(iSeries 版)
メモ:DB2 U2.1 コネクタが作成したテーブルに DB2 U3.x コネクタを使用してアクセスする必
要があり、対応するエンティティにセグメント フィールド(たとえば、パッキング コード SC*
があるフィールド)が含まれている場合は、その segmented fields のコネクタ設定をオフにし
ます。
[DRIVER_SETTINGS]
DB2 U3.0
USYS$DB2_PARAMS segmented fields : off
3
クライアント(または IDF)アサインメント ファイルを編集して、$DB2 パスを Uniface ルー
ターが動作するマシンに変更します。
たとえば、タイプが ANY の Uniface サーバーを起動するには、サーバーのアサインメント
ファイルのものと同じ $DB2 設定(メンバ DBMS の内容を参照)を使用します。
$DB2 = TCP:iSeries+13001|user|pass
$DEF = $DB2
これで、クライアントはサーバーのアサインメント ファイルの $DB2 パスに指定された
iSeries ライブラリのテーブルにアクセスできます。
データベース サーバーのロールで Uniface サーバーを起動するには:
$DB2 = TCP:iSeries+13001|user|pass + DB2:RDBDIRE:LIBRARY||
$DEF = $DB2
上記の RDBDIRE と LIBRARY は、サーバーにある DBMS のアサインメント ファイルと同じ値に
します。つまり、実際の値に置き換える必要があります。
メモ:$DB2 設定のコロンや縦線を削除しないように注意してください。
メモ:テーブルは存在しなければ実行時に作成されますが、(コレクションである)ライブラリ
そのものはすでに存在することが前提であるため作成されません。
4
コネクタの SQL スクリプトを編集して、データベース名とユーザー名をアプリケーションに
合わせて調整します。
第 2 章 iSeries への Uniface のインストール
31
Uniface リポジトリの作成用に、以下の SQL スクリプトが Uniface の配布キットで提供されて
います。
表 2-1. iSeries(AS/400)用 DB2 テーブル作成 SQL スクリプト
アプリケーション モデル
DB2 U3.x SQL スクリプト
DICT
db23as4dt.sql
PRINTER
db23as4pt.sql
STATE
db23as4at.sql
SYSENV
db23as4st.sql
TEXT
db23as4tt.sql
2.3.1 DDS で生成した物理ファイルの定義のロード
DDS が生成する物理ファイルは、SQL コレクションにも SQL スキーマにもない非 SQL テーブル
です。このようなテーブルを iSeries の DB2 データベースにロードするには、以下の手順を実行し
ます。
◆
入力に物理ファイルを使用して、iSeries Navigator で生成されたダミー SQL テーブルのある、
ダミー SQL コレクションを作成します。
◆
Uniface で、このライブラリのテーブルで定義のロードを実行し、キーのチェックや修正を行
います。
◆
ダミー コレクションを削除します。
これらの定義をロードする手順の詳細を以下に示します。
1
iSeries Navigator がインストールされている Windows PC で、iSeries Navigator を起動し、
[Server]>[Databases]>[Libraries] の順に選択します。
2
定義をロードする物理ファイルが含まれているライブラリを右クリックし、[Generate SQL]
を選択します。
ライブラリのファイルがリストされている画面が表示されます。
3 (ライブラリ自体も含めて)不要なファイルをすべてリストから削除し、下部にある
[Generate] ボタンをクリックします。
[Run SQL scripts] ダイアログが開き、選択した各ファイルの SQL ステートメント CREATE
TABLE が表示されます。
32
Uniface インストール/構成ガイド(iSeries 版)
4
スクリプトを編集します。
最初の CREATE TABLE ステートメントの前に、CREATE COLLECTIONDummy ステートメン
トを挿入します。Dummy はダミー SQL コレクションの名前です。
元のライブラリ名のオカレンスをすべて Dummy コレクションの名前に置き換えます。
5
編集後、メニューの [Run]>[All] を選択します。
これで、ダミー SQL コレクションと、選択した各物理ファイルの SQL テーブルが作成されま
す。
6
Uniface 側で、Uniface IDF のクライアント アサインメント ファイルを編集し、以下のように
$DB2 パスを変更します。
$DB2 TCP:iSeries+13001|user|pass + DB2:RDBDIRE:Dummy||
Dummy はダミー SQL コレクションです。RDBDIRE をローカル リレーショナル データベースの
名前に置き換えます。
7
Uniface IDF を起動し、定義のロードを実行します。
8
あとで、元の物理ファイルが入っているライブラリを指すように、アサインメント ファイルの
$DB2 パスを復元します。これでダミー ライブラリを削除できます。
生成された SQL には、一部またはすべてのテーブルの「プライマリ キー」キーワードが入ってい
ないかもしれません。IDF モデル エディタで、そのようなエントリのキー フィールドを選択する
必要があります。
また、物理ファイルのキーが UNIQUE でないか NON-NULL プライマリ キーの場合、定義のロー
ドによってキーは生成されません。これらのエントリにはキーを手動で選択してください。
メモ:Uniface が使用する物理ファイルには、常にジャーナル処理を実行する必要があります。
実行しないと、挿入と更新ができません。
2.4 iSeries での Uniface ルーターの構成
Uniface ルーターを構成するには、そのアサインメント ファイルを編集する必要があります。
iSeries の場合、インストール時に作成される UROUTER アサインメント ファイル メンバがその
ファイルとなります。
Uniface ルーターのアサインメント ファイル メンバ UROUTER には、以下のような設定が含まれ
ています。
[SETTINGS]
第 2 章 iSeries への Uniface のインストール
33
;$putmess_logfile = UNIFxxxx/rout%p.log
[SERVERS] ; Specify USTs here:
default = userver -maxidle=3m
; For Uniface WebApplication Server
wasv = userver -maxreq=1000 -asn=wasv.asn
[SERVERS] セクションでは、デフォルト Uniface サーバー(default)と Uniface Web アプリケー
ション サーバー(wasv)の UST(Uniface サーバー タイプ)、さらに各サーバーのコマンド ライ
ン パラメータを定義します。[SERVERS] セクションにエントリを追加して、Uniface サーバーに
さまざまなパラメータを指定できます。
クライアント アサインメント ファイルの $DB2 設定では、パスワードの直後にパイプ(|)と
UST を順に追加できます。これにより、userver プログラムを使用して指定のパラメータで
Uniface サーバーを起動するように Uniface ルーターに指示できます。UST を指定しない場合、
Uniface ルーターは default UST を使用して、タイプが ANY の Uniface サーバーを起動します。
たとえば、wasv UST をクライアントの $DB2 設定に追加する場合は、以下のようにします。
$DB2 TCP:iSeriesMachineName+Port|username|password|wasv
これで、Uniface サーバー(USERVER)がコマンド ライン パラメータ -maxreq=1000 と asn=wasv.asn で(UROUTER によって)起動されます。上記の例で、wasv.asn はサーバーのア
サインメント ファイルで、Uniface Web アプリケーション サーバーのアサインメント設定が記載
されています。
Uniface ルーターを構成するには、メンバ UROUTER を変更します。
1
[SERVERS] セクションでは、Uniface ルーターがアクセスする Uniface サーバーの UST を定
義します。「Uniface サーバー用の UST の定義」を参照してください。
Uniface ルーターも自身のパラメータを数多く挿入します。Uniface サーバーが受け入れ可能
なフラグや引数を追加したり削除したりできます。
2
オプションで、[PRE_START] セクションに、Uniface ルーターが自動的に事前起動する
Uniface サーバーを定義します。「Uniface サーバーの事前起動」を参照してください。
3
[SETTINGS] セクションには、クライアント、Uniface サーバー、および Uniface ルーター モ
ニタの数を制限するためのデフォルト設定を指定します。
4
34
◇
$MAXSERVERS — Uniface ルーターが起動できる Uniface サーバーの最大数。
◇
$MAXCLIENTS — Uniface ルーターが受け入れ可能なクライアントの最大数。
◇
$MAXMONS — Uniface ルーターが受け入れ可能な Uniface ルーター モニタの最大数。
必要に応じて、Uniface ルーターのスタートアップ パラメータを変更します。
Uniface インストール/構成ガイド(iSeries 版)
5
変更を保存し、Uniface ルーターを再起動します。「iSeries での Uniface ルーターの起動」を
参照してください。
これまでの変更がすべて有効になります。
2.4.1 Uniface サーバー用の UST の定義
Uniface ルーターのアサインメント ファイル urouter.asn に、Uniface サーバー タイプ(UST)
を定義します。このファイルは、Uniface のインストール ディレクトリの adm ディレクトリに配置
されています。
UST を定義するには、以下の手順を実行します。
1
urouter.asn の [SERVERS] セクションで、以下のフォーマットを使用して UST の定義を追
加します。
Microsoft
Windows
UST="InstallDir\bin\userver.exe"
{CommandLineSwitches}
UNIX
UST="/InstallDir/bin/userver"
{CommandLineSwitches}
OpenVMS
UST="Disk:[Installdir.
bin]userver"
{CommandLineSwitches}
iSeries
UST="userver"
{CommandLineSwitches}
UST に対して使用する適切なコマンド ライン スイッチの情報については、[SETTINGS ] を参
照してください。
たとえば、Windows の場合は以下のようになります。
[SERVERS]
sales = "c:\Compuware\Uniface\bin\userver.exe" /asn=\usr\sales\sales.asn /
maxreq=100
UNIX の場合は以下のようになります。
[SERVERS]
sales = "/compuware/uniface/bin/userver" /asn=/usr/sales/sales.asn /maxreq=100
OpenVMS の場合は以下のようになります。
[SERVERS]
sales = "disk:[compuware.uniface.bin]userver" /asn=/usr/sales/sales.asn /maxreq=100
iSeries の場合は以下のようになります。
第 2 章 iSeries への Uniface のインストール
35
[SERVERS]
sales = userver -asn=/usr/sales/sales.asn -maxreq=1000
Uniface ルーターは、以下の場合に DEFAULT という名前の UST を使用します。
◇
クライアントで指定されている UST が、urouter.asn で定義されていない場合
◇
クライアントで UST が指定されていない場合
◇
Uniface ルーターが、UST のアサインメント ファイルを見つけられない場合
DEFAULT UST が urouter.asn で指定されていない場合、コマンド ライン スイッチはデ
フォルトで以下の値になります。
2
◇
/dir — Uniface ルーターの作業ディレクトリ
◇
/asn — アサインメント ファイル usysadm:userver.asn
◇
/max — 無制限
◇
/maxreq — 無制限
◇
/maxidle — 無制限
urouter.asn で宣言されている各 UST について、アサインメント ファイルを作成します
(sales.asn など)。
2.4.2 Uniface サーバーの事前起動
Uniface ルーターは、起動時に、自動的にサーバー(Uniface サーバー インスタンス)の事前起動
を行うことができます。
これは、以下のような場合に便利です。
◆
起動するサーバーが実質的に常に利用できる必要があるサービスで、クライアントと直接接続
されていない場合
◆
クライアントがサーバーに接続した時点で、そのサーバーを使用できる状態にしておきたい場
合
サーバーを事前起動しておくことで、マシンを再起動した直後にサーバーが使用できる状態になり
ます。
メモ:サーバーの事前起動は、一度だけ実行されるアクションです。サーバーが予期せず終了
した場合、Uniface ルーターはサーバーの再起動を行いません。このようなサーバーは、
Uniface ルーター モニタを使用して再起動できます。
36
Uniface インストール/構成ガイド(iSeries 版)
Uniface ルーターは、サーバーの起動時にユーザー名とパスワードを要求します。この情報は、通
常はクライアントの要求によって提供され、クライアント アサインメント ファイルのパスで定義
されます。
Uniface サーバーを事前起動するには、以下の手順を実行します。
1
urouter.asn を更新します。
1
[PRE_START ] セクションを追加または編集します。
ここには、クライアント アサインメント ファイルで ANY サーバーを指定する場合と同
様のパス定義が記述されています。
2
起動するサーバーを 1 行に 1 つずつ入力します。また、それぞれが一意になるようにしま
す。
以下の点を確認します。
◇
各行には、[SERVERS] セクションで定義されている単一のサーバーの UST を指定する必
要があります。これは、Uniface ルーターが行ごとに単一のサーバーを事前起動するため
です。たとえば、以下のように指定します。
[PRE_START]
tcp:host|user1|pass1|ust1
tcp:host|user2|pass2|ust1
tcp:host|user2|pass2|ust2
[SERVERS]
ust1 = userver /asn=asn1.asn /dir=d:\dir1
ust2 = userver /asn=asn2.asn /dir=d:\dir2
◇
一意のサーバーを指定する規則に従いながら、同じマシンで同じ 2 つのサーバーを事前起
動する場合は、以下のように一意のホスト名を 2 行で指定します。
[PRE_START]
tcp:host1|user1|pass1|ust1
tcp:host2|user1|pass1|ust1
◇
ホスト フィールドはオプションであり、空のままにすることができますが、パイプ記号が
必要になります。以下に例を示します。
tcp:|user1|pass1|ust1
ホスト名フィールドは、実際には使用されません。Uniface ルーターがこの情報を自動的
に決定します。
◇
サーバーは、[PRE_START] セクションで指定された順序で起動されます。ただし、UST
に対して指定された $MAXSERVERS または /max の制限を超えることはありません。
◇
プロトコル、ユーザー、パスワード、UST の各パラメータは必須です。
第 2 章 iSeries への Uniface のインストール
37
◇
/ex スイッチと /su(または -nosu)スイッチは、UST のあとの [PRE_START] 行、ま
たは [SERVERS] セクションの UST 定義で指定できます。
UNIX では、排他的サーバーは独自のリスン ポートを開きます(/gates スイッチと同
様)。
◇
その他のスイッチはすべて、[SERVERS] セクションの UST 定義でのみサポートされ、指
定することができます。
◇
事前起動では、ANY サーバーのみがサポートされています。
◇
Uniface ルーターのアサインメント ファイルでは、ユーザー名とパスワードをスクランブ
ルする方法は用意されていません。
2
Uniface ルーターを停止して再起動します。
上述の例では、Uniface ルーターが、[PRE_START] セクションの 3 つの行で指定された 3 つの
サーバーを起動します。このうち 2 つのサーバーは、[SERVERS] セクションの user1 と user2 に
関する ust1 定義を使用して起動され、3 つめのサーバーは、user2 に関する ust2 定義を使用して
起動されます。
2.4.3 Uniface ルーターへのクライアントの登録
Uniface クライアントが、Uniface ルーターを通じて別の Uniface アプリケーション(クライアン
トまたはサーバー)からメッセージを受信する場合は、それらのクライアントを個別に Uniface
ルーターへ登録する必要があります。クライアント アプリケーションは、コマンドライン、クライ
アント アサインメント ファイル、PROC 言語、または排他的サーバーのいずれかを使用して登録
できます。
Uniface ルーターは、登録されたクライアントとそのパスを維持します。これによって、Uniface
ルーターは登録されたすべてのクライアントにメッセージを送信できるようになります。
Uniface ルーターにクライアントを登録するには、以下のいずれかの操作を実行します。
1
/dnp と /ust コマンド ライン スイッチを使用して、コマンド ラインから登録します。
Microsoft Windows
uniface.exe/
dnp=TCP:HostID+Port|||ClientIDStartUpShell
または
uniface.exe/dnp=TCP:HostID+Port/
ust=ClientIDStartUpShell
38
Uniface インストール/構成ガイド(iSeries 版)
UNIX、OpenVMS、
iSeries
uniface/dnp=TCP:HostID+Port|||ClientIDStartUpShell
または
uniface/dnp=TCP:HostID+Port/
ust=ClientIDStartUpShell
◇
HostID — Uniface ルーターを実行しているホスト マシンの識別子です。
HostID のフォーマットにより、使用する TCP プロトコルのバージョンが決まります。詳
細については、「TCP/IPv6」を参照してください。
HostID フィールドは空のままにすることができますが、パイプ記号が必要になります。
以下に例を示します。
tcp:|user1|pass1|ust1
◇
Port — クライアントが Uniface ルーターとの通信時に使用する、ホスト マシン上の
TCP ポート番号です。
◇
ClientID — クライアントが Uniface ルーターに対して自身を識別するために使用する
ID です。この名前は、大文字と小文字を区別しません。
◇
StartUpShell — クライアント上の、アプリケーション スタートアップ シェルの名前で
す。
2
クライアント アサインメント ファイルを使用して登録します。$DNP 設定に、クライアントの
パスを指定します。
$DNP TCP:HostID+Port|||ClientID
HostID のフォーマットにより、使用する TCP プロトコルのバージョンが決まります。
3
PROC の open コマンドを使用して登録します。
open ステートメントは、以下のように使用します。
open "HostID|||ClientID","$DNP"
HostID のフォーマットにより、使用する TCP プロトコルのバージョンが決まります。
4
排他的サーバーを使用します。
Uniface クライアントは、Uniface サーバー(データベース サーバー、ファイル サーバー、ま
たはアプリケーション サーバー)と、TCP 経由で排他的な接続を確立することができます。
この場合、Uniface ルーターはサーバーの起動のみ行います。クライアントはルーターから切
断され、起動されたサーバーに直接再接続します。これ以上、ルーターがクライアントからの
要求をルーティングすることはありません。
クライアントでは、アサインメント ファイルで以下のように /ex スイッチを使用して、排他
的サーバーとの接続を指定します。
第 2 章 iSeries への Uniface のインストール
39
$DEF = TCP:myhost|ben|?| /ex + SRU:|||
または
$DEF = TCP:myhost|ben|?|UST1 /ex + ORA:|scott|tiger
メモ: ある Uniface ルーターから別のルーターにホップする場合は、/ex スイッチを使用でき
ません。
クライアント側の /ex スイッチは、Uniface ルーターのアサインメント ファイルで /shr ス
イッチが使用されていない場合にだけ機能します。
2.4.4 Uniface ルーターのスタートアップ パラメータの変更
Uniface ルーター(UROUTER)を起動するためのパラメータはインストール時に指定され、
STARTUP プログラムにコンパイルされます。このため、スタートアップ パラメータを変更するに
は、STARTUP ファイルのメンバ STARTUP を編集し、再コンパイルしたあと Uniface ルーターを
再起動する必要があります。
インストール後に Uniface ルーター パラメータを変更するには、以下の手順を実行しま
す。
1
Uniface ルーターを停止します。
サブシステムを作成した場合は、サブシステムを停止します。
ENDSBS (UNIFxxxx) OPTION(*IMMED)
サブシステムを作成しなかった場合は、以下のコマンドを入力します(UROUTER はポート
13001 をリスンしているものとします)。
CALL PGM(*CURLIB/UROUTER) PARM('TCP:+13001' '/shut')
メモ:サブシステムを作成した場合にも、この方法で UROUTER を停止できますが、サブシス
テムが実行されたままになります。その場合、あとで UROUTER を再起動する際に、サブシス
テムを開始するのではなく STARTUP を実行する必要があります。
2
STARTUP ソースを編集します(
「インストール内容」の「スタートアップ プログラム」を参
照)。
例の 3 行めには、PARM('TCP:+13001') のようなパラメータが含まれています。以下の点を確
認します。
◇
◇
40
追加の引数は単一引用符で囲むこと
かっこやプラス記号を削除しないこと [ )(+ ]
Uniface インストール/構成ガイド(iSeries 版)
◇
このメンバのコマンドが正規の CL シンタックスであること
◇
追加のパラメータが UROUTER で使用可能なものであること。コネクタの割り当てと
Uniface ルーター コマンド ライン スイッチが、使用可能なパラメータとなります。
たとえば、UROUTER アサインメント ファイルの場所を変更するには、3 行めに以下のよう
に /asn= パラメータを追加します。
PARM('TCP:+13001' '/asn=UNIFxxxx/MYUROUTER.ASN') +
3
編集した STARTUP ソースを以下のようにコンパイルします。
CRTCLPGM PGM(UNIFxxxx/STARTUP) SRCFILE(UNIFxxxx/STARTUP)
コンパイル エラーが発生しなければ、Uniface ルーターの STARTUP プログラムが新しいパラ
メータで作成されます。
4
Uniface ルーターを再起動します。
サブシステムを停止することで UROUTER を停止していた場合は、サブシステムをもう一度
開始します。
STRSBS UNIFxxxx/UNIFxxxx
サブシステムを使用していなかった場合は、STARTUP を実行して UROUTER を起動します。
CALL UNIFxxxx/STARTUP
これで、Uniface ルーターは新しいパラメータで起動しました。「Uniface ルーターの実行の確認」
を参照して、UROUTER が実行されていることを確認します。
2.4.5 iSeries での Uniface ルーターの起動
Uniface ルーターを起動するには、サブシステムを起動するか、または STARTUP を呼び出しま
す。どちらになるかは、インストールでサブシステムを作成するようにしたかどうかによって異な
ります。
インストール時にサブシステムを作成した場合は、インストール ライブラリにサブシステム記述が
作成されます。ライブラリとサブシステムの名前は通常、UNIF9101 というように
UNIFVersionNumber 形式になっています。
Uniface ルーターを起動するには、以下の手順を実行します。
1
サブシステムを使用して、以下のコマンドを入力します。
STRSBSLibraryName/SubsystemName
たとえば、ライブラリが UNIFxxxx で、サブシステム名も UNIFxxxx であるとします。
STRSBS UNIFxxxx/UNIFxxxx
第 2 章 iSeries への Uniface のインストール
41
これでサブシステムが起動します。サブシステムには、STARTUP プログラムを実行する自動
開始ジョブがあります。次に、インストール時に指定したパラメータとユーザー プロファイル
を使用して、STARTUP が UROUTER を起動します。
2
サブシステムを作成しなかった場合は、以下のコマンドを入力します。
CALLLibraryName/STARTUP
以下に例を示します。
CALL UNIFxxxx/STARTUP
2.4.6 Uniface ルーターの実行の確認
UROUTER が実行されていることを確認するには、以下の手順を実行します。
1
WRKACTJOB を実行し、その出力で UROUTER を探します。
WRKACTJOB 画面にサブシステムがアルファベット順にリストされています。スクロールし
て該当するサブシステムを表示する必要があります。
インストール時にサブシステムを作成した場合は、以下のような記述があります。
UNIFxxxx
UROUTER
QSYS
UNIFSID
SBS
BCH
.0
.0
PGM-UROUTER
DEQW
TIMW
サブシステムを作成せず、CALL コマンドで Uniface ルーターを起動した場合、UROUTER
ジョブはインストール時に選択したサブシステムの下にあります。これがデフォルトの
QBATCH の場合、以下のように表示されます。
QBATCH
UROUTER
QSYS
UNIFSID
SBS
BCH
.0
.0
PGM-UROUTER
DEQW
TIMW
どちらの場合も、2 行めの UROUTER 行は、UROUTER が正常に起動し、インストール時に
指定したポートをリスンしていることを示しています。
1 行めだけで 2 行めが表示されない場合は、UROUTER の起動に失敗しています。
2
Uniface ルーターの起動に失敗した場合は、以下の手順を試してください。
1
インストール ライブラリの LOG ファイルを調べます。
問題の原因が UROUTER アサインメント ファイルのエラーにある場合は、Uniface エ
ラー メッセージが記載されている LOG ファイルに、メンバ ROUTJobProcessId があり
ます(JobProcessId はジョブ プロセスの ID 番号)。
メモ:LOG ファイルの名前と場所を変更するには、UROUTER のアサインメント ファイルで
$putmess_logfile 設定を使用します。
2
42
UROUTER が生成した QPJOBLOG スプール ファイルを調べます。
Uniface インストール/構成ガイド(iSeries 版)
*PGM オブジェクトや *SRVPGM オブジェクトが見つからない、といったオペレーティ
ング システムが検出したエラーは、ここに記録されます。
メモ:このスプール ファイルが作成されるようにするには、UROUTER を起動する前に、ジョ
ブ記述のメッセージ ログ レベルを 4 00 *SECLVL に(一時的に)上げることが必要になる場
合もあります。このスプール ファイルは、UROUTER ジョブを所有するユーザー プロファイ
ルに所有されます。
3
NETSTAT のオプション 3 を使用して、指定したポートが UROUTER で使用可能かどう
かを確認します。
使用できない場合は、UROUTER の起動に失敗します。
4
これらの結果に基づいて、インストール時に UROUTER に指定したパラメータに対する
変更や追加を検討します。
たとえば、LOG ファイルにダンプする情報を増やすには /pri=255 を追加する必要があり、
ポート番号を変更するには対応するパラメータを変更する必要があります。
2.5 iSeries での Uniface デプロイメント ユーティリティの実行
Uniface デプロイメント ユーティリティ(UDEPLOY)を使用すると、コンポーネント、シグニ
チャ、アプリケーション全体などがあるデプロイメント アーカイブを iSeries に簡単に配置できま
す。これを正しく行うには、ユーティリティがデプロイメント アーカイブにアクセスできるように
する必要があります。
ユーティリティがデプロイメント アーカイブにアクセスできるようにするには、以下の
いずれかを実行します。
◆
バイナリ モードで FTP を実行して、アーカイブを物理ファイル メンバまたは IFS ディレクト
リに転送します。
◆
アーカイブを iSeries にある IFS ディレクトリに転送し、PC 上の Microsoft エクスプローラを
使って、ドラッグ アンド ドロップで共有の IFS ディレクトリに移します。
Uniface デプロイメント ユーティリティを実行するには、以下の手順を実行します。
1
必要に応じて、どのファイルも IFS に向かうように UDEPLOY アサインメント ファイルを変
更します。
アーカイブを実行する際、デフォルトでオブジェクトはカレント ライブラリに置かれます。
.frm、.svc、.urr などのオブジェクトの拡張子がファイル名になり、オブジェクト名の残り
の部分がメンバ名になります。たとえば、myform.frm は、物理ファイル FRM のメンバ
第 2 章 iSeries への Uniface のインストール
43
MYFORM になります。myverylongnamedform.frm というようにフォームの名前が長い場
合は、メンバ名として使用できないため、配置が失敗します。また、たとえば XML 物理ファ
イルのレコード長より長い行のある XML ファイルの場合、行がラップされ、その XML ファ
イルは使用できません。
配置時にこのような問題が発生しないようにするには、どのファイルも IFS にリダイレクトす
るように UDEPLOY アサインメント ファイルを変更して、どのオブジェクトも IFS ディレク
トリに配置します。その場合、アプリケーションが IFS でこのようなファイルを探すように、
アプリケーションのアサインメント ファイルも更新する必要があります。
メモ: 配置の前に UDEPLOY ではなく USYS アサインメント ファイル メンバを修正すると、
デプロイメント ユーティリティと配置されたアプリケーションの両方が、自動的に同じ IFS の
場所をこれらのオブジェクトに使用することになります。
2
コマンド ラインから、以下のコマンドを入力します。
CHGCURLIB UNIFxxxx
CALL UDEPLOY PARM('arg1' 'arg2')
UDEPLOY に指定する引数はすべて、単一引用符で囲む必要があります。以下に例を示しま
す。
CALL UDEPLOY PARM('/hlp')
この場合、UDEPLOY で指定可能なフラグのリストが表示されます。
2.5.1 iSeries での Uniface サービスの実行
サービスを実行するには、Uniface サーバーがサービスのシグニチャを検出し、サービスに合った
.svc ファイルを検出できることが必要です。サービスに必要な DOL ファイルがアクセス可能でな
ければなりません。また、シグニチャがデータベースにない場合は、URR ファイルも必要です。
どのファイルも、Uniface サーバー(USERVER)に使用する iSeries に直接コンパイルしたり生
成したりできます。
Uniface サービスを実行するには、以下の手順を実行します。
1
Uniface デプロイメント ユーティリティを使用して、シグニチャとそれ以外の必須ファイルと
共にサービスを配置します。デプロイメント アーカイブからアプリケーション全体を配置する
こともできます。
この他に以下の方法もあります。
44
Uniface インストール/構成ガイド(iSeries 版)
◇
iSeries IFS ディレクトリを Microsoft Windows PC のドライブとしてマップします。そう
すれば、Windows エクスプローラを使用して、マップされた IFS ドライブに Uniface で
生成したすべてのファイルをドラッグ アンド ドロップできます。
iSeries のサーバー アサインメント ファイルを変更して、マップされた IFS ドライブから
USERVER がこれらのファイルにアクセスできるようにすることを忘れないでください。
◇
FTP で iSeries に転送します。ただし、ミスが発生しやすいため、この方法はお勧めしま
せん。
FTP を使用する場合は、*.frm、*.aps、*.svc、*.usp、*.urr、*.dol の各ファイ
ルをバイナリで転送してください。
また必要に応じて、*.dsc ファイルと *.hts ファイルを FTP の ascii で転送します。
2
クライアント側で、目的のサービスの起動を iSeries Uniface ルーター(UROUTER)にリダ
イレクトします。
以下に例を示します。
[PATHS]
$DB2 = TCP:Machinename+13001|User|Password
[SERVICES_EXEC]
A* $DB2:A*
この例では、A で始まる名前のすべてのサービスのクライアントによる起動が、iSeries の
ANY USERVER に転送されます。詳細については、
「リモート サービスとレポートのアサイ
ンメント」を参照してください。
2.5.2 iSeries での Uniface バッチ アプリケーションの実行
バッチ アプリケーションを実行するには、必要なファイルを Uniface ですべて検出できることが必
要です。
「Run Uniface services on the iSeries」で説明する方法に従って、検出したファイルを
iSeries で利用可能な状態にすることができます。
バッチ アプリケーションに必ず入っているのは、アプリケーション スタートアップ シェル(.aps
ファイル)です。
バッチ アプリケーションをサブミットするには、以下の手順を実行します。
1
DLM インストール ディレクトリがライブラリ リストにあることを確認します。
2
以下のシンタックスを使用して、Uniface プログラムを呼び出します。
CALL PGM(UNIFLIB/
UNIFACE)PARM(UnifaceFlagsStartUpShellApplicationParameters)
第 2 章 iSeries への Uniface のインストール
45
◇
UnifaceFlags — Uniface コマンド ライン スイッチ(必要な場合)。どのスイッチも単
一引用符で囲む必要があります。Uniface フラグはすべて、アプリケーション スタート
アップ シェル名の前に置く必要があります。
単純なバッチ アプリケーションを実行するには、/bat フラグを使用します。このあとに、
/pri=0 など別の Uniface フラグを続ける必要があります。
/bat フラグを使用しない場合、厳密に言うとバッチ アプリケーションではなくなります。
この場合、フォームは内部では描かれるものの、表示されません。ユーザーの介在を必要
としないかぎり、このタイプのアプリケーションは稼動します。ユーザーの介在が必要に
なるとすぐに、そのアプリケーションはミューテックスを待機して永久にロックされま
す。
/bat を使用しない場合は、アプリケーションがユーザーの介在を必要としないように、
PROC コードに注意する必要があります。
◇
StartUpShell — アプリケーション スタートアップ シェルの名前(.aps 拡張子なし)。
◇
ApplicationParameters — アプリケーション固有のパラメータ(必要な場合)。どの
パラメータも単一引用符で囲む必要があります。
3
ALWMLTTHD(*YES) オプションを使用してジョブをサブミットします。
このオプションが必要になるのは、Uniface プログラムがマルチスレッドであるためです。
/asn フラグが使用されていなければ、スタートアップ シェルと同じ名前のアサインメント ファイ
ル メンバ、およびメンバ USYS が読み取られます。
例
たとえば、mybatch.aps にコンパイルされたバッチ アプリケーションを実行するには、以下のよ
うにジョブ待ち行列 QBATCH にサブミットします。
ADDLIBLE DLM41
SBMJOB
CMD(CALL PGM(UNIFLIB/UNIFACE) PARM('/pri=63'
MYBATCH 'arg1' 'arg2'))
JOB(MYBATCH)
CURLIB(UNIFLIB)
ALWMLTTHD(*YES)
この例では、アプリケーションに必要な引数が 2 つあり、ログ ファイルに $ioprint=63 の出力を
行うものとします。
46
Uniface インストール/構成ガイド(iSeries 版)
第 3 章 Web デプロイメントの
構成
3.1 iSeries での Web 実行環境の構成
Uniface Web 環境を設定するには、Web アプリケーション サーバー アーキテクチャのさまざまな
要素を、相互に正しく動作するように構成する必要があります。基本構成から始めて、個々のコン
ポーネントで追加設定を行い、ステップごとにコンポーネントが相互に正しく動作するかどうかを
テストする、という設定方法を取っていきます。
メモ:以降の手順は、WebSphere Application Server - Express(V5R3 以上で使用するバー
ジョン 6.0)に適用できます。
Uniface アーキテクチャとそのコンポーネント、Web リクエスト ディスパッチャ(WRD)、および
Web サービスを十分に理解していることが前提となります。
webapps ディレクトリと webext ディレクトリが収録されている Uniface インストール CD が必
要です。いずれのディレクトリも iSeries にコピーされます。
Uniface Web 環境を構成するには、以下の手順を実行します。
1
iSeries での wrd.war ファイルの作成
2
新たな WebSphere アプリケーション サーバーの作成
3
WebSphere アプリケーション サーバーへの WRD のインストール
4
WebSphere での WRD のテスト
3.1.1 iSeries での wrd.war ファイルの作成
IBM WebSphere Application Server では、.war ファイル(または .ear ファイル)形式のアプリ
ケーションを配置できます。Uniface Web リクエスト ディスパッチャ(WRD)サーブレットは、
この形式ではないため、.war ファイルにパッケージ化する必要があります。これを行うには、
47
Qshell 環境で iSeries を使用するか、Java 2 SDK 1.4 がインストールされた Windows マシンを使
用します。
iSeries で war ファイルを作成するには、以下の手順を実行します。
1
webapps ディレクトリの設定
2
WRD の構成
3
wrd.war ファイルの構築
webapps ディレクトリの設定
アプリケーション サーバーで必要なファイルを格納するための webapps ディレクトリを iSeries
に作成しておく必要があります。
webapps ディレクトリを設定するには、以下の手順を実行します。
1
webapps ディレクトリとその内容を iSeries にコピーします。
Uniface インストール CD には、.war ファイルに必要なファイルが入った webapps という
ディレクトリがあります。
iSeries Navigator を使用して、IFS のホーム ディレクトリなどに「Share」を作成します。
Microsoft Explorer を使用して、Uniface インストール CD からこの共有フォルダに webapps
ディレクトリをドラッグ アンド ドロップします。
2
CD から(\AS2\bin\webext にある)webext ディレクトリを webapps ディレクトリの
Uniface ディレクトリにコピーします。
Microsoft Explorer を使用して、共有にある webapps\uniface ディレクトリにこのディレク
トリをドラッグ アンド ドロップします。
3
コピー元の webext ディレクトリの名前を common に変更します。
webapps/uniface ディレクトリの下に以下のサブディレクトリがあることを確認します。
◇
common
◇
css
◇
WEB-INF
WRD の構成
WRD は、受け取った要求を処理する Uniface ルーターを検出する必要があります。
48
Uniface インストール/構成ガイド(iSeries 版)
WRD を構成するには、以下の手順を実行します。
1
Microsoft Windows の場合、../webapps/uniface/WEB-INF ディレクトリに移動し(「Set
Up the webapps Directory」を参照)、ファイル web.xml を開いて編集します(まず Readonly 属性の削除が必要になることがあります)。
iSeries 上で編集するには、EDTF または WRKLNK のいずれかの CL コマンドとオプション 2
を使用します。
2
web.xml 内で、UV8: 接続文字列の 2 つのオカレンスを検索します。以下のようなオカレンス
です。
<param-value>UV8:localhost+13001|userver|userver|wasv</param-value>
3
オカレンスごとに、適切なホスト識別子、ポート番号、ユーザー名とパスワード、UST を入力
します。他の構成設定も指定できますが、この段階では必要ありません。
接続文字列は、以下の要素で構成されています。
◇
UV8: — WRD 接続文字列のはじめを示します。変更しないでください。
◇
HostID+PortNumber — WRD 要求を受け取る UROUTER を指定します。Uniface を
ローカルにインストールする場合は、HostID に localhost を使用できます。
iSeries の UROUTER がリスンしているポート番号がわからない場合は、WRKACTJOB
のオプション 5 とオプション 10 を使用して、ジョブ ログを表示します。その最初の行に、
UROUTER が起動された方法とポート番号が示されています。
◇
|Username|Password — Uniface サーバーの許可ユーザー名とパスワード。区切り記号
には、パイプ記号(|)を使用します。
◇
|UST — Uniface ルーターが Uniface サーバーを起動するために認識できる有効な UST。
つまり、Uniface ルーターのアサインメント ファイル urouter.asn の [SERVERS] セク
ションにエントリがあるものです。Uniface をデフォルト設定でインストールした場合、
wasv というエントリがあり、通常は変更の必要はありません。区切り記号にはパイプ記
号を使います。
第 3 章 Web デプロイメントの構成
49
wrd.war ファイルの構築
wrd.war ファイルを構築するには、以下の手順を実行します。
1
iSeries のコマンド ラインで QSH と入力して Qshell を起動したあと、以下の処理を実行しま
す。
1
カレント ディレクトリを webapps ディレクトリのコピー先の IFS ディレクトリに変更し
ます(「Set Up the webapps Directory」を参照)
。
2
2
カレント ディレクトリを webapps/uniface に変更します。
以下のコマンドを使用して、webapps/uniface の各ディレクトリを .war ファイルにパッ
ケージ化します。
jar -cf wrd.war *
3
wrd.war ファイルをターゲットの iSeries に転送します。
ターゲットの iSeries 以外のマシンでここまでの手順を実行した場合は、バイナリ モードの
FTP か、共有 IFS ディレクトリへのドラッグ アンド ドロップを使用して、ターゲットの
iSeries に wrd.war ファイルを転送する必要があります。
4
この時点で、webapps ディレクトリを削除できますが、wrd.war は削除しないでください。
3.1.2 新たな WebSphere アプリケーション サーバーの作成
この手順を実行する前に、iSeries のコマンド ラインで「ping localhost」と入力して、ホスト ID の
localhost が有効であることを確認してください。localhost が有効でない場合、WebSphere では新
しいアプリケーション サーバーを作成できません。localhost が機能していることを確認したあと、
以下の手順に進みます。
新たに Web アプリケーション サーバーを作成するには、以下の手順を実行します。
1
Web ブラウザを起動し、iSeries の HTTP 管理 Web ページに移動します。
http://iSeriesNetworkName:2001
(デフォルトのポート番号が 2001 ではない場合は、この URL に実際のポート番号を使用して
ください)
要求された URL が見つからないというエラーが表示された場合は、HTTP 管理サーバーが動
作していることを確認します。そのためには、[Network]>[Servers]>[TCP/IP] で iSeries
Navigator を使用します。iSeries Navigator の右ペインに、HTTP Administration というエ
ントリがあります。そのステータスが Started になっていない場合は、右クリックし、[Start]
を選択します。この他、以下の CL コマンドを使用して起動する方法もあります。
STRTCPSVR SERVER(*HTTP)
50
Uniface インストール/構成ガイド(iSeries 版)
HTTPSVR(*ADMIN)
30 秒ぐらいおいてから、上記のリンクを試してください。
2
ユーザー名とパスワードが要求されたら、HTTP サーバーを管理できる権限のある、有効な
OS/400 のユーザー プロファイル名とパスワードを入力します。
3
[iSeries Tasks] ページで、[IBM Web Administration for iSeries] リンクをクリックします。
4
[IBM Web Administration for iSeries] ページで、[Manage] タブを選択します。
5
左ペインで、[Common Tasks and Wizards] の [Create Application Server] をクリックしま
す。
右側に WebSphere Application Server の作成に関する情報ページが表示されます。ページの
一番下にある [Next] をクリックします。
6
アプリケーション サーバーの名前(UNIFACE など)と説明を入力します。次に、[Next] をク
リックします。
7
オプションで、HTTP サーバーを Uniface サーバーに関連付けます。また、[Do not associate
an external HTTP server with this application server] を選択することもできます。
以降のステップは、HTTP サーバーがないという前提の説明です。終了したら、[Next] をク
リックします。
8
アプリケーション サーバーがリスンするポート番号を入力します。
アプリケーション サーバーには、連続した 15 のポート番号が予約されます。このポート番号
は、実行予定の Uniface ルーターのポート番号と競合しないようにしてください。HTTP サー
バーを関連付けなかった場合、あとで WRD にアクセスする際に、ここで入力したポート番号
を URL に指定する必要があります。終了したら、[Next] をクリックします。
9
サンプル アプリケーションをインストールするように求められた場合は、Hello が含まれてい
る DefaultApplications サンプルを選択できます。
WRD には何も必要ありませんが、アプリケーション サーバーが機能するかどうかをテストす
る場合には Hello を使用できます。これで、wrd.war ファイルをインストールする前に、アプ
リケーション サーバーをテストできます。終了したら、[Next] をクリックします。
10 [Identity Tokens] で、[Next] をクリックします。
これらは特に必要がないかぎり、デフォルトのままとし、構成しないでください。WRD には、
これらの設定は必要ありません。
最後のサマリ ページで、これまでの設定内容を確認します。サンプル アプリケーションにア
クセスする URL も表示されます。以降のプロセスで作成されるアプリケーション サーバーの
テストに使えます。
第 3 章 Web デプロイメントの構成
51
11 [Finish] をクリックして、作成プロセスを開始します。
使用するマシンのタイプとその作業負荷によっては、作成プロセスはかなり時間を要します。
WRKACTJOB を使うと進行状態をモニタできます。QHTTPSVR サブシステムでは、JVM
ジョブの一部がアプリケーション サーバーの作成に使用されます。
定期的にリフレッシュされる [Web administration] ページでは、左ペインの上部に黄色の丸と
[Creating] という文字が表示されます。作成プロセスが終了すると、[Manage All Servers]
ページが自動的に表示されます。そのリストには作成されたアプリケーション サーバーが掲載
されており、ステータスが Stopped になっています。
12 その新規アプリケーション サーバーを選択し、[Start] をクリックします。
丸の色が黄色になり、ステータスが Starting に変わります。
アプリケーション サーバーの起動には、しばらく時間がかかります。また、このページは自動
的にリフレッシュされないため、定期的に [Refresh] をクリックする必要があります。
Starting が Running に変わると、アプリケーション サーバーが実行されていることになりま
す。
13 DefaultApplications サンプルをインストールした場合は、新規アプリケーション サーバーを
テストします。
新たにブラウザを開き、サマリー ページに表示された hello アプリケーションの URL を入力
します。デフォルトのポート番号を変更していなければ、以下の URL です。
http://iSeriesNetworkName:10000/hello
この URL で、「Hello from the WebSphere Application Server!」というテキストが含まれる
ページが表示されます。
3.1.3 WebSphere アプリケーション サーバーへの WRD のインストール
前のセクションで作成し、WRD サーブレットが含まれている WAR ファイル(wrd.war)を以下
の手順で配置する必要があります。
WRD をインストールするには、以下の手順を実行します。
1
wrd.war ファイルを iSeries IFS に転送します。
iSeries IFS に wrd.war ファイルをまだ移していない場合は、バイナリ モードの FTP を使用
するか、Windows エクスプローラでドラッグ アンド ドロップする方法で、共有 IFS ディレク
トリにこのファイルを転送します。
2
[Web Administration] ページで、[Manage] タブを選択します。
トップ タブの下に、さらに 4 つのタブがあります。
52
Uniface インストール/構成ガイド(iSeries 版)
3
[Application Servers] タブで、[Server] から新たに作成したアプリケーション サーバーを選択
します。
この場合は、UNIFACE/UNIFACE – V6.0 になります。
4
左ペインで、[WAS Wizards] の [Install New Application] をクリックします。
右側に、[Install New Application] ページが表示されます。2 つの選択肢があります。
[Application is contained in an EAR file] または [Application is contained in a WAR file] で
す。
5
[Application is contained in a WAR file] を選択します。
このページに [IFS path of WAR file] エディット ボックスが(場合によっては赤色で)表示さ
れるまで少し待機します。
6
IFS で wrd.war ファイルへの完全修飾絶対パスを入力または参照します。
2 番めのエディット ボックスには、[Context root] というラベルが付いており、URL のマシン
名とポート番号のあとに続く部分が入ります。たとえば、Uniface WRD にアクセスする URL
が以下のようになっているとします。
http://iSeriesNetworkName:10000/uniface/...
この場合、/uniface がコンテキスト ルートです。
次ページには、アプリケーション名として [Uniface Web Request Dispatcher] が表示されま
す。
7
[Next] をクリックして、デフォルトのままとします。
次のページは仮想ホストの ID に関する設定です。
8
以前に作成したホストがある場合は、ドロップダウン リストからそのホストを選択します。そ
のようなホストがない場合は、[Next] をクリックして、デフォルト default_host を受け入れま
す。
9
[Finish] をクリックして、WRD WAR ファイルのインストールを開始します。
新しいページに、アプリケーション サーバーに現在インストールされているすべてのアプリ
ケーションのリストが表示されます。その中に [Uniface Web Request Dispatcher] が入ってい
ますが、その前に砂時計のアイコンが付いた黄色の丸があります。これは、インストールが進
行中であることを示しています。
これも使用するマシン タイプとその作業負荷によっては、かなりの時間を要する場合がありま
す。完了すると黄色の丸が赤に変わり、WRD がインストールされ、稼動はしていないことを
示します。
第 3 章 Web デプロイメントの構成
53
3.1.4 WebSphere での WRD のテスト
WRD をテストするには、以下の手順でアプリケーション サーバーを起動します。
1
[Web Administration] ページで、[Manage] タブを選択します。
トップ タブの下に、さらに 4 つのタブがあります。
2
[Application Servers] タブを選択します。
3
タブの下にある [Server: ] ドロップダウン リストで、作成したアプリケーション サーバーを選
択します。この例では、UNIFACE/UNIFACE – V6.0 という名前になっています。
4
アプリケーション サーバーが動作していない場合は、左側にある緑色の [Play] ボタンをク
リックして、アプリケーション サーバーを起動します。その緑色のボタンの左に Running と
表示されるのを待ちます。
5
左ペインで、[Applications] の [Manage Installed Applications] をクリックします。
右側にインストールされているアプリケーションのリストが表示されます。その中に
[UNIFACE Web Request Dispatcher] が入っており、ステータスが Stopped になっています。
6
WRD を選択し、[Start] をクリックします。
メモ:[Start] ボタンが使用不可である場合は、[Enablement] フィールドを見ると WRD が起動
されているかどうかがわかります。そのフィールドが有効になっていれば、WRD は起動されて
います。有効になっているアプリケーションは、アプリケーション サーバーが起動するときに
起動します。
7
別のブラウザを立ち上げて、以下の URL を入力します。
http://iSeriesNetworkName:PortNumber/ContextRoot/testwrd/run/index
実際の値は、たとえば以下のようになります。
http://myas400:10000/uniface/testwrd/run/index
◇
PortNumber —「Create a new Application Server」で指定したポート番号。
◇
ContextRoot —「Install the WRD in the Application Server」で指定したコンテキスト
ルート。
数秒後、[UNIFACE Test Middleware response] ページが表示されます。これは、WRD とアプリ
ケーション サーバーが正しく設定されていることを示します。
54
Uniface インストール/構成ガイド(iSeries 版)
3.2 iSeries での USP と Web サービスの配置
Uniface サーバー ページ(USP)と Web サービスを実行するように iSeries 上で Uniface を構成す
るには、サーバー ページまたは Web サービスをその関連するファイルとシグニチャ、さらに対応
するアサインメント ファイル設定と共に、iSeries に移動する必要があります。
サーバー ページと Web サービスを配置するには、以下の手順を実行します。
1
iSeries での Uniface Web アプリケーション サーバーの構成
2
サービスの作成と実行
3
Web サービスとしてのサービスの実行
3.2.1 iSeries での Uniface Web アプリケーション サーバーの構成
web.xml ファイルでは、Uniface ルーターが Uniface サーバーを起動するのに使用する UST が、
接続文字列の最後の要素となります。これはデフォルトで wasv に設定されています。Uniface
ルーターのアサインメント ファイルの [SERVER] セクションには、以下のような wasv のエントリ
があります。
wasv = userver -asn=wasv.asn
Uniface ルーター(UROUTER)は、UST wasv の最初の要求を受け取ると、新たに Uniface サー
バー(USERVER)インスタンスを起動します。USERVER では、アサインメント ファイル
wasv.asn が使用されます。このアサインメント ファイルには、Web を有効にする特別な設定は
不要ですが、サービスが適切に実行されるための設定と、パスやファイルのリダイレクションが必
要です。ここで示す例のサービスは特別なものを必要としません。文字列の長さが戻されるだけで
す。
このサンプル サービスを開発する簡単な方法は、クライアント IDF のアサインメント ファイルを
編集して、web.xml に使用したのと同じ接続文字列の UST wasv を使用して、サービス ファイル
(websrv.svc)と udesc.urr ファイルを iSeries にリダイレクトすることです。これらのファイ
ルを iSeries に移すには、FTP や iSeries Navigator を使用するなど、その他の方法もあります。
クライアント IDF アサインメント ファイルを以下のように編集します。
1
このような用途では、アサインメント ファイルに $TESTMODE_COMPONENTS、
$SEARCH_DESCRIPTOR、または $SEARCH_OBJECT がある場合、一時的にいずれもコメントア
ウトします。
2
[SERVICES_EXEC] セクションへのエントリを追加します。
[SERVICES_EXEC]
WEBSRV $WASV:WEBSRV
第 3 章 Web デプロイメントの構成
55
3
[PATHS] セクションへのエントリを追加します。
[PATHS]
$WASV TCP:iSeriesNetworkName+Port|User|Pass|wasv
ここで、WASV 設定のコンテンツは、web.xml に入力したとおりにしますが、以下の部分だ
けは異なります。
◇
UV8: を TCP: に置き換えます。
◇
web.xml でリテラル localhost を使用した場合は、iSeries の実際のネットワーク名に置き
換えます。
以下に例を示します。
$WASV TCP:myAS400+13001|userver|userver|wasv
4
オプションで、iSeries に .svc ファイルを作成できます。
[FILES] セクションに以下の内容を追加します。
[FILES]
websrv.svc
$WASV:websrv
この設定を追加すると、.svc ファイルはコンパイル時に iSeries に作成されます。追加しない
場合には、FTP または iSeries Navigator を使用して、このファイルを iSeries に移動できま
す。
3.2.2 サービスの作成と実行
Web サービスとして使用されるサービスを作成します。
Uniface サービスを作成して実行するには、以下の手順を実行します。
1
Uniface 開発環境(IDF)を起動して、1 つのモデルとエンティティ、いくつかのフィールド、
そのエンティティのキーを作成します。それらの名前や使用するフィールド数は任意です。
2
以下のような簡単な PROC が含まれる callin というオペレーションのある WEBSRV という
サービスを作成します。
operation callin
params
string parmin : in
numeric parmout: out
endparams
parmout = $length(parmin)
putmess "WEBSRV: %%parmin%%%"
return (parmout)
end; callin
56
Uniface インストール/構成ガイド(iSeries 版)
3
このサービスをコンパイルします。クライアント IDF のアサインメント ファイルで
websrv.svc をリダイレクトした場合は、websrv.svc ファイルは iSeries 上に作成されます
(wasv.asn で特に指定していなければ、ファイル SVC のメンバ WEBSRV)。まだリダイレク
トしていなかった場合は、FTP または iSeries Navigator を使用して、このファイルを iSeries
に移動します。
4
Microsoft Windows クライアント上で idf.exe /urr を実行します。アサインメント ファイルで
udesc.urr をリダイレクトした場合は、iSeries 上に直接それが作成されます。まだリダイレ
クトしていなかった場合は、FTP または iSeries Navigator を使用して、このファイルを
iSeries に移動します。
この時点で、サービス ファイル websvc.svc と(udesc.urr ファイルにある)そのシグニ
チャを、Uniface が iSeries インストールに利用できるようになっています。
5
フロント エンドにフォームを作成し、3 つのエディット ボックス TF1、TF2、D1 とコマンド
ボタンを 1 つ描きます。
6
コマンド ボタンの Detail トリガに、以下の PROC を追加します。
activate "WEBSRV".callin(TF1, TF2)
D1=$status
7
このフォームをコンパイルしてテストします。WEBSRV サービスの起動を iSeries にリダイレ
クトしているため、iSeries 上のサービスが起動されます。
8
TF1 フィールドに任意の文字列を入力して、コマンド ボタンをクリックします。
9
WRKACTJOB を使用して、[F5] キーを繰り返し押すと、USERVER インスタンスが iSeries
で起動します。数秒後、TF2 と D1 に入力した文字列の長さが示されます。
すべて上記のように動作した場合、web.xml に入力した接続文字列で Uniface サービスが正しく
実行されます。上記のように動作しない場合は、問題の場所を見つけて修正します。これがうまく
いかなければ、Web サービスのクライアント アプリケーションでもうまくいかないからです。正
しく動作させるには IDF のアサインメント ファイルの $WASV パスを変更する必要がある場合に
は、その同じ変更を web.xml にも行います。
3.2.3 Web サービスとしてのサービスの実行
「サービスの作成と実行」の説明に従って、Uniface サービスを作成します。
この時点で、サービスは iSeries 上で適切に実行されますが、まだ Web サービスではありません。
Web サービスにするには、そのサービスを起動する Web サービス クライアントへの WEBSRV の
インタフェースを記述する .wsdl ファイルが必要です。
第 3 章 Web デプロイメントの構成
57
サービスを Web サービスとして実行するには、以下の手順を実行します。
1
以下のコマンド ラインで idf.exe を実行して、.wsdl ファイルを作成します。
idf.exe /sto /mwr=ws WEBSRV
これで、カレント ディレクトリに websrv.wsdl というファイルが作成されます。
2
このファイルを使用するように WRD を構成します。
ファイルを WEB-INF/wsdl ディレクトリに移動し、wrd.war ファイルを(再)構築して
(再)配置する必要があります。詳細については、「wrd.war ファイルの構築」を参照してくだ
さい。
3
WRD jar ファイルに含まれる SRD(Uniface SOAP リクエスト ディスパッチャ)がこのファ
イルにアクセスできることを確認するため、Web ブラウザを起動して以下の URL を入力しま
す。
http://iSeriesNetworkName:10000/uniface/services/websrv.wsdl
ブラウザに、wsdl ファイルの内容が表示されます。これは、SRD がそのファイルにアクセス
できたということです。エラー メッセージが表示された場合、SRD がファイルにアクセスで
きなかったことになります。この場合は、wsdl ファイルが適切な場所にあることと、その
ファイルが wrd.war ファイルにインクルードされていることをチェックします。
これで、このサービスは Web サービスになり、Web サービス クライアントによって起動でき
ます。
4
Windows で Uniface Web サービス コールアウトを使用してこのサービスをテストする場合
は、以下のように idf.exe を実行して、Web サービス wsdl をインポートします。
idf.exe /sti /mwr=ws http://iSeriesNetworkName/uniface/services/websrv.wsdl
iSeries 上の SRD から提供される wsdl が読み取られ、WEBSRVSERVICE という SOAP シ
グニチャが作成されます。
5
テストには、前のセクションで作成したテスト フォームを使用します。コマンド ボタンの
Detail トリガで、PROC を以下のように変更します。
activate "WEBSRVSERVICE".callin(TF1, TF2)
D1=$status
6
IDF のアサインメント ファイル idf.asn の [DRIVER_SETTINGS] セクションに、SOP =
U1.0 を追加します。
7
IDF を再起動し、前と同じ方法でフォームを再コンパイルしてテストします。
今回は、コマンド ボタンをクリックすると IDF は Web サービス クライアントとして動作し、
以下が実行されます。
58
Uniface インストール/構成ガイド(iSeries 版)
◇
SRD から WEBSRV の wsdl が取り出されます。
◇
それを使用して、SOAP メッセージを構築します。
◇
wsdl が iSeries の HTTP サーバーに送られます。
◇
Websphere アプリケーション サーバーが SRD を実行します。
◇
SRD が UROUTER に要求を転送します。
◇
UROUTER が USERVER プロセスを起動します。
◇
USERVER インスタンスがプロセスを実行します。
第 3 章 Web デプロイメントの構成
59
60
Uniface インストール/構成ガイド(iSeries 版)
第 4 章 構成ファイル
Uniface の構成ファイルには以下のものがあります。
◆
アサインメント ファイル(*.asn)— アプリケーションの場所、言語、デフォルトを確立する
設定が含まれています。通常、各アプリケーションと Uniface 製品には、独自のアサインメン
ト ファイルがあります。ただし、組織の要件に合わせたファイルの名前付け、構成、連結が可
能です。
◆
初期化ファイル(*.ini)— クライアントで使用する GUI リソースと言語設定を決定する設定
が含まれています。一部の GUI 機能は、カレント オペレーティング システムに依存します。
ユーザーによるユーザー インタフェースのデフォルトの設定が可能です。
◆
Web アプリケーション ファイル(web.xml)—Uniface Web アプリケーションの実行に使用
される WRD サーブレットを構成する設定が含まれています。
メモ:Uniface 開発環境は Uniface アプリケーションであるため、アサインメント ファイルと
初期化ファイルを使用して、開発環境をカスタマイズすることができます。
4.1 アサインメント ファイル
Uniface アプリケーションの環境は、アサインメント ファイルによって決定されます。このファイ
ルは、Uniface のデフォルト設定、エンティティの保管先、使用する DBMS などを指定する、「ア
サインメント」と呼ばれる 1 つまたは複数の設定を含む ASCII テキストファイルです。Uniface の
アサインメント ファイルには、拡張子 .asn が付きます。
アサインメント ファイルを使用すると、Uniface アプリケーションの環境を管理することができま
す。以下の操作が可能です。
◆
アプリケーションの開発、テスト、実稼動用に、個別の環境を作成する
◆
メッセージとヘルプのテキストで使用する言語を指定する
61
◆
使用するキーボードとデバイスの変換テーブルを指定する
◆
アプリケーションが参照する DBMS テーブルの場所を定義する
◆
アプリケーションがアクセスする非 DBMS ファイルの場所を定義する
◆
使用するネットワークプロトコルとサーバー ホストの場所を指定する
アプリケーションに固有の設定を含むローカル アサインメント ファイルを作成できます。アサイ
ンメント ファイルの作成または編集には、任意の ASCII ファイル エディタを使用できます。
デフォルトのアサインメント ファイル
デフォルトのアサインメント ファイルは、Uniface のインストール時に自動的に作成されます。た
とえば、以下のアサインメント ファイルが、Uniface のインストール ディレクトリ(USYSADM:)
のサブディレクトリ(\adm)に作成されます。
◆
usys.asn — すべての Uniface アプリケーションで使用します。
◆
usyschr.asn — キャラクタ モードで実行するすべての Uniface アプリケーションで使用しま
す。
◆
idf.asn — Uniface 開発環境で使用します。
◆
urouter.asn — Uniface ルーターで使用します。
◆
urmon.asn — Uniface ルーター モニタで使用します。
◆
wasv.asn — Uniface Web アプリケーション サーバーのデフォルトのアサインメント ファイ
ルです。
4.1.1 アサインメントのシンタックス
アサインメント ファイルには複数のアサインメントが記述されており、各アサインメントは単一の
行に記述されています。アサインメントを後続の行に続けて記述することはできません。
いくつかの例外を除き、アサインメントは常に以下のシンタックスで記述します。
Setting{=}Assignment
◆
Setting — Uniface で使用する名前。この名前は、設定名、Uniface が非 DBMS ファイルを
検索するのに使用する論理名、DBMS テーブル名またはファイル名などにすることができま
す。
◆
Assignment — Setting に対するアサインメント。この値は、設定、非 DBMS ファイルの名
前、DBMS ファイルのターゲットなどに対応する 1 つまたは複数の値にすることができます。
2 つの部分は、複数のスペース、タブ、単一の等号(=)で区切ります。
インストール ディレクトリの参照
アサインメント ファイルでは、USYS: は、インストール ディレクトリを表す特殊記号として認識
されます。Uniface は、インストール ディレクトリで検索するファイルの論理名に、この特殊記号
62
Uniface インストール/構成ガイド(iSeries 版)
を接頭部として追加します(USYS:usys.asn など)。アサインメントの右側部分で、インストール
ディレクトリの正確なディレクトリ名を何度も指定する代わりに、USYS: を使用することができま
す。
インストール ディレクトリの場所を特定する方法は、プラットフォームによって異なります。たと
えば、UNIX では環境変数 $USYS を使用して場所を定義しますが、Microsoft Windows では .ini
ファイルの設定を使用します。
大文字と小文字
Uniface システムの設定、パラメータ、パス名、コネクタのニーモニックでは大文字と小文字が区
別されませんが、通常は大文字が使用されます。大文字と小文字のどちらでも使用できますが、い
ずれかに統一することをお勧めします。
テーブル、ファイル、ログオンを指定する場合に大文字と小文字のどちらを使用するかは、オペ
レーティング システムまたは DBMS(あるいはその両方)に依存します。たとえば、UNIX では大
文字と小文字が区別されますが、Microsoft Windows では区別されません。
簡単なルールとして、アサインメントの左側の部分では大文字と小文字が区別されませんが、右側
の部分ではコンテキストに応じて区別される場合があります。
ワイルドカード
アサインメント ファイルでは、アスタリスク(*)をワイルドカード文字として使用します。
パスの割り当てでワイルドカードを使用する場合は、以下の点に注意します。
◆
アプリケーションに固有のアサインメントは、グローバル アサインメント ファイルではなく
ローカル アサインメント ファイルに配置します。
アプリケーションが特定のエンティティを特定するためにアサインメントを検索する場合、
ローカル アサインメントの前にグローバル アサインメントを検索します。たとえば、
ENT2.MYMODEL を特定する必要がある場合にグローバル アサインメント *.MYMODEL =
$SOL が検索されると、検索対象としてより適切なローカル アサインメント
ENT2.MYMODEL = $ORA よりも優先してこのグローバル アサインメントが使用されてしま
います。
◆
Uniface は最初に条件に一致した指定を使用するため、ワイルドカードを使用したアサインメ
ントは、具体的なアサインメントのあとに配置します。
4.1.2 パスとパスの割り当て
パスは、アプリケーションが必要とするリソースへの名前付きルートです。DBMS コネクタへのパ
ス、ネットワーク コネクタへのパス、リモート サーバーへのパス、GUI コネクタへのパス、別の
第 4 章 構成ファイル
63
パスへのパスがあります。パスの割り当てとは、リソースにパスをマップする設定のことです。パ
スは他のパスにリダイレクトできるため、柔軟に構成できます。
パス メカニズムを使用すると、基礎となる DBMS へのルートを各 DBMS が処理できる数だけ作成
できます。複数のルートを作成する利点は、システム管理者が DBMS を切り替えたり、同じ
DBMS の別のデータベースに I/O をリダイレクトしたり、程度がさまざまに異なるオペレータ権限
を適用したりすることが容易になることです。パス メカニズムは、アプリケーションを実稼働さ
せ、データベース I/O をテスト データから実稼働データに変更するときなどに便利です。
パスの割り当て
パスの割り当てでは、通常、データベースへのルートを定義します。たとえば、以下のパスの割り
当てを指定すると、SOLID DBMS コネクタと物理データベースに移動します。
$SOL SOL:nmpipe MyDatabase:|DBUsername|DBPassword
論理パスと物理パス
DBMS への物理パスと論理パスがあります。物理パスは DBMS またはネットワーク ドライバに至
るもので、ノード名やデータベース名の他に、ログオン情報も含めることができます。以下に例を
示します。
$DBMS = sol:nmpipe Flow_Deployment:|Uniface|flow
論理パスは、あるパスを別のパスに割り当てることによって作成されます。以下に例を示します。
$MyTextDB = $DBMS
論理パスには、任意の名前を使用できます。
パスの割り当てのタイプ
パスの割り当てのタイプは、それぞれ特定の用途に使用されます。
◆
ファイルを割り当てるか名前を変更する、ファイルとファイルの割り当て。詳細については、
「ファイルの割り当てとリダイレクション」を参照してください。
◆
サーバーベースのファイルを参照する、ファイルとパスの割り当て。
◆
DBMS またはネットワーク コネクタのログオン情報を提供する、パスとコネクタの割り当て。
詳細については、「パスとコネクタの割り当て」を参照してください。
◆
アプリケーション モデル エンティティをあるパスから別のパスに向ける、パスとパスの割り
当て。詳細については、「パスとパスの割り当て」を参照してください。
◆
エンティティとパスの割り当て:
◇
64
1 つのエンティティまたはエンティティのグループを別のパスに向けるため
Uniface インストール/構成ガイド(iSeries 版)
◇
1 つのエンティティまたはエンティティのグループのターゲット テーブルの名前を変更す
るため
◇
パスがレコードレベル DBMS に至るものである場合にターゲット ディレクトリを指定す
るため
詳細については、「エンティティとパスの割り当て」を参照してください。
4.1.3 インストール後に使用できるパス
Uniface のインストール後、自動的に複数のパスを使用できるようになります。これらのパスを、
以下の表に示します。
表 4-1. インストール後に使用できるパス
パス
説明
各 DBMS またはネットワーク コネクタ、あるいはインストールされている GUI ドライバの場
合:
$xyz
デフォルト パス($SYB、$TCP など)
$INS_xyz
インストール パス($INS_SYB、$INS_TCP など)
その他のパス:
$DEF
インストール時にデフォルトとして選択された DBMS へのパス。
Uniface Flow では使用されません。
$IDF
アプリケーション オブジェクト リポジトリのアプリケーション モ
デル DICT と、Uniface Flow の組織モデルやプロセス モデルを含む
DBMS へのパス
$SYS
アプリケーション オブジェクト リポジトリのアプリケーション モ
デル PRINTER と SYSENV を含む DBMS へのパス
$UUU
アプリケーション オブジェクト リポジトリのアプリケーション モ
デル TEXT を含む DBMS へのパス
$SRU
Uniface サーバーとレポート コンポーネントの実行に使用されるリ
モート サーバーへのパス
$WFM
Uniface Flow のワークフロー インスタンスとセッション データへの
パス
第 4 章 構成ファイル
65
4.1.4 2 パス構造
Uniface のインストールに含めた各コネクタについて、インストール手順によってそのコネクタへ
の 2 パス構造が作成されます。デフォルト パスはインストール パスにリダイレクトされ、インス
トール パスはコネクタ自体にリダイレクトされます。
たとえば、インストールに Sybase のコネクタを含めた場合、自動的に以下のパスが作成されます。
◆
デフォルト パス $SYB
◆
インストール パス $INS_SYB
◆
コネクタ自体、SYB
◆
デフォルト パス $SYB をインストール パス $INS_SYB にダイレクトするアサインメント
◆
インストール パス $INS_SYB をコネクタ SYB にダイレクトするアサインメント
この構造は、インストールに含めた各 DBMS、ネットワーク、GUI コネクタで使用されます。各
コネクタは、3 文字のコネクタ コードによって識別されます。たとえば、TCP/IP のネットワーク
コネクタを含めた場合、デフォルトのアサインメント ファイルには、デフォルト パス $TCP、イン
ストール パス $INS_TCP、コネクタ TCP が自動的に指定されます。
Uniface では、このような 2 パス構造を作成することで、$SYB、$DEF、$IDF など複数のパスか
ら、$INS_SYB などの単一のパスにチャネルをオープンできるようにしています。
2 パス構造の特徴は、以下のとおりです。
◆
一度にオープンする DBMS へのパスの数を、最小限に抑えることができます。これは、オー
プンできる「チャネル」の数や使用できるログオン数に制限のある DBMS では重要です。
◆
1 つのアサインメントだけで、他の DBMS またはネットワークへの複数のパスを切り替える
ことができます。たとえば、$DEF を $INS_CIS から $INS_SYB に変更したり、$SYB を
$INS_SYB から $INS_CIS に変更したりして切り替えることができます。
この 2 パス構造は、インストールが完了すると作成されていますが、状況によっては不要な場合も
あります。どのような場合でも、独自のアサインメントを使用することで、環境を定義することが
できます。
4.2 パスとコネクタの割り当て
パスとコネクタの割り当てはクライアントのアサインメント ファイルで使用され、ローカル デー
タベース コネクタ、ネットワーク コネクタ、Uniface サーバー コネクタに対して、ログオン情報
を提供します。
◆
66
データベース コネクタ パスは、ローカル データベース コネクタを参照します。
Uniface インストール/構成ガイド(iSeries 版)
◆
ネットワーク コネクタ パスは 1 つまたは複数のネットワークを参照し、通常は Uniface サー
バーの参照で終了します。
◆
Uniface サーバー コネクタ パスは、データベース サーバー、ファイル サーバー、アプリケー
ション サーバー、コンポーネント サーバー、または ANY サーバーを参照します。このサー
バーの前に、1 つまたは複数のネットワーク参照を記述する必要があります。
4.2.1 データベース コネクタ パス
データベース コネクタ パスはローカル データベース コネクタを参照します。このコネクタが、パ
ス割り当てで参照される唯一のコネクタでなければなりません。
シンタックス:
$Path{=}DBmnemonic:{DBMS}|{UserName|Password}
◆
$Path — デフォルト パスの名前($SOL など)またはインストール パス($INS_SOL など)
◆
DBmnemonic — データベース コネクタ用の 3 文字の Uniface ニーモニック。例:SOL
◆
DBMS — データベース名(該当する場合)
。例:SOLID
◆
UserName — DBMS ログオン名
◆
Password — UserName のパスワード
以下に例を示します。
;Path to local database
$SOL = SOL:nmpipe SOLID:|test|data
メモ:DBmnemonic、UserName、Password は、それぞれを疑問符(?)で置換するか、完全
に省略することができます。不足している情報がターゲット コネクタで必要な場合は、データ
ベースのログオン ダイアログ ボックスが表示されます。
4.2.2 ネットワーク コネクタ パス
ネットワーク コネクタ パスは 1 つまたは複数のネットワークを参照し、通常は Uniface サーバー
の参照で終了します(以下を参照)。
シンタックス:
$Path{=}NetConnector{+...NetConnector}{|UST}{/ex}
NetConnector のシンタックスは以下のとおりです。
NetworkMnemonic:{HostID}{+Port}|{UserName}|{Password}
◆
$Path — ユーザー定義パスの名前
第 4 章 構成ファイル
67
◆
NetworkMnemonic— ネットワーク コネクタ用の 3 文字の Uniface ニーモニック。例:TCP
◆
HostID — ホストのネットワーク ノード名。例:SERVERHOST または 127.0.0.1
HostID のフォーマットにより、使用する TCP プロトコルのバージョンが決まります。詳細に
ついては、「TCP/IPv6」を参照してください。
◆
Port — Uniface ルーター プロセスがリスンする HostID のポート番号
◆
UserName —HostID にログオンするためのログオン名とその他のオペレーティング システム
固有の情報。その他の情報としては、HostID が UserName のチェックを行うために使用する
ドメイン名などが挙げられます。
たとえば、Marketing\JohnDoe は Windows プラットフォームで使用され、Marketing がド
メイン名で JohnDoe がユーザー名です。バックスラッシュ(\)で区切られています。また、
JohnDoe+Marketing は z/OS で使用され、JohnDoe がユーザー名で Marketing がドメイン名
です。プラス記号(+)で区切られています。
Password — HostID にログオンするための UserName のパスワード。
◆
メモ:HostID(Port を含む)、UserName、Password は、それぞれを疑問符(?)で置換す
るか、完全に省略することができます。不足している情報がターゲット コネクタで必要な場合
は、ネットワークのログオン ダイアログ ボックスが表示されます。
UST — Uniface サーバー タイプ。HostID にある Uniface ルーター アサインメント ファイル
◆
urouter.asn の [SERVERS] セクションで宣言されている特定の Uniface サーバーの名前を
指定します(DATA、ASV など)。UST を省略すると、デフォルトのサーバー タイプ
(DEFAULT)が使用されます。
/ex —HostID で実行されている Uniface サーバーを、このクライアント セッションで排他的
◆
にします。Uniface サーバーは、他のクライアント セッションと共有されません。/ex スイッ
チは、リスト内の最後のネットワーク コネクタ参照のあとでのみ使用できます。
例:
;Path to a server specified by the UST "gen"
$TCP = TCP:host|user|password|gen
4.2.3 Uniface サーバー コネクタ パス
Uniface サーバー コネクタ パスは、データベース サーバー、ファイル サーバー、アプリケーショ
ン サーバー、コンポーネント サーバー、または ANY サーバーを参照します。このサーバーの前
に、常に 1 つまたは複数のネットワーク参照を記述する必要があります。このため、必ず以下のよ
うなパス構成になります。
$Path {=} NetworkPath+DatabaseServerPath
68
Uniface インストール/構成ガイド(iSeries 版)
$Path {=} NetworkPath+UnifaceServerPath
各項目の内容は以下のとおりです。
◆
◆
$Path — ユーザー定義パスの名前
NetworkPath — ネットワーク コネクタ パス。「ネットワーク コネクタ パス」のセクション
を参照してください。
◆
DatabaseServerPath — データベース コネクタ パスとまったく同じになります。シンタッ
クス(「データベース コネクタ パス」で説明されています)は、以下のようになります。
DBmnemonic: { DBMS } | { UserName|Password }
データベース パスまたはログインは、1 つだけです。
◆
UnifaceServerPath — 指定されたロールで機能している Uniface サーバーを参照します。
シンタックスは、以下のようになります。
ServerMnemonic:||
ServerMnemonic は固定ニーモニックで、前に記述されているネットワーク コネクタが、
ネットワーク パスにおいて指定されたロールで Uniface サーバーを起動することを示します。
表 4-2. Uniface サーバーのロール
サーバー ニー
モニック
サーバー ロール
コメント
FIL
Uniface ファイル サー
バー
ユーザー名とパスワードは必須ではありません
SRU
Uniface アプリケーション
サーバー
ユーザー名とパスワードは必須ではありません
S3C
Uniface コンポーネント
サーバー
ユーザー名とパスワードは必須ではありません
ANY
ANY サーバー
ANY サーバーは、任意のタイプのサーバーとし
て機能できます。ユーザー名とパスワードは必
須ではありませんが、複数のデータベース パス
またはログインを持つことができます。
サーバー コネクタ パスが指定されていない場合は、ANY サーバーと同じになります。
例:
;Path to database server on host
第 4 章 構成ファイル
69
$DATA = TCP:host|user|password|data + SOL:SOLID:|dbuser|dbpassword
;Path to file server on host
$FILESERVER = TCP:host|user|password|files + FIL:||
4.2.4 ルーターのホップ
複数のネットワーク コネクタが指定されている場合、Uniface は、Uniface ルーターを経由して最
後のコネクタにホップします。最後の Uniface ルーターでは、 UserName と Password を使用
したログオン情報が必要となります。その他の Uniface ルーターは、どのようなクライアントでも
受け入れます。Uniface ルーターは、最大 8 つまで連結できます。
以下に例を示します。
;Path to SOLID server on host2 behind a firewall
$DATA = TCP:host1||| + TCP:host2|user|password|hop +
SOL:SOLID:|dbuser|dbpassword
メモ:この Path シンタックスは、Post メッセージまたは DNP 登録では使用できません。登録
できる Uniface ルーターは 1 つだけで、他の Uniface ルーターを経由して登録することはでき
ません。
4.2.5 DBMS チャネル
フィールド レベル DBMS では、多くの場合、コネクタへの各パスは、その DBMS へのチャネルに
なります。つまり、異なるログオンになります。DBMS に対するオープン チャネル数は、DBMS
が処理できるチャネル数の範囲内であれば、ほとんどの場合 Uniface でサポートされています。た
だし、複数のログオンをサポートしていない DBMS もあります。
4.2.6 ログオン情報
ログオン情報が必要なコネクタへのパスに最初にアクセスする場合は、データベースまたはネット
ワーク ログオン ダイアログ ボックスにログオン情報を入力する必要があります。この操作は、必
要な情報がすでに使用できる状態になっている場合は不要です。データベース サーバーと ANY
サーバーのデータベース ログインの違いについては、「Uniface サーバー コネクタ パス」のセク
ションを参照してください。
70
Uniface インストール/構成ガイド(iSeries 版)
例:クライアント上での一般的なパスの割り当て
以下に、クライアント アサインメント ファイルで一般的に使用されるパスの割り当ての例を示し
ます。
;Path to file server on host
$FILESERVER = TCP:host|user|password|files + FIL:||
;Path to application server on host
$APPLICATIONSERVER = TCP:host|user|password|services + SRU:||
;Path to component server on host
$COMPONENTSERVER = TCP:host|user|password|components + S3C:||
;Path to ANY server on host
$TCP = TCP:host+13001|user|?|ust + ANY:||
;Path to ANY server on host
$TCP = TCP:host|user|password
;Path to exclusive database server on host
$DATA = TCP:host|user|password|data /ex + SOL:SOLID:|dbuser|dbpassword
;Path to exclusive ANY server on host
$TCP = TCP:host+13001|user|?|ust /ex
4.3 構成ファイル
4.3.1 dbms.asn
dbms.asn ファイルは、DBMS アサインメント設定を含む基本アサインメント ファイルです。
プロパティ
◆
デフォルトの場所:UnifaceInstallDir\adm
説明
dbms.asn ファイルは、idf.asn や wasv.asn などの他の基本アサインメント ファイルに含まれ
ています。これは Uniface のインストール中に作成されます。このファイルは、それぞれの環境に
合わせて修正できます。
例:サンプル データベース アサインメント ファイル
; Sample database assignment file
[DRIVER_SETTINGS]
SOL U3.4
SEQ
U1.0
第 4 章 構成ファイル
71
SYB U2.b
USYS$SYB_PARAMS = charset ISO_1
...
[PATHS]
$SOL SOL:nmpipe sampledb:|uniface|nine
$SYB SYB:sampledb.uniface|uniface|nine
$SYS $SOL
$UUU $SYS
$IDF $SYS
$DEF $SYS
4.3.2 idf.asn
idf.asn ファイルは、Uniface 開発環境に固有の設定を含みます。
プロパティ
◆
デフォルトの場所:UnifaceInstallDir\adm
説明
idf.asn ファイルには、データベースへのパスのリダイレクション用に dbms.asn ファイルが含
まれています。これは、デフォルトで SOLID 開発データベースを指します。
独自の開発環境を作成するには、このアサインメント ファイルをローカルのアサインメント ファ
イルに含め、独自の開発データベースに対してデータベース リダイレクションを再定義します。そ
して、このアサインメント ファイルを IDF で使用します。
メモ:idf.asn は、Uniface のバージョンごとに異なります。これは変更しないで、ローカル
の開発アサインメント ファイルに含めるだけにすることをお勧めします。
例:idf.asn の使用
ここでは、一般的な開発アサインメント ファイルの例を示します。これには、Uniface 開発環境を
使用するために必要な設定を有効にする usysadm:idf.asn が含まれます。usysadm:idf.asn
を含めたあと、データベースへのパスが再定義されてすべてのデフォルト定義が上書きされ、ロー
カル ファイルのインダイレクションが定義されます。
; myidf.asn
; used with command line: idf.exe /asn=myidf.asn
[SETTINGS]
72
Uniface インストール/構成ガイド(iSeries 版)
; My local settings:
$variation = system_library
$putmess_logfile = myidf.log
$trc_start = myidf_trace.log
$search_descriptor = dbms_first
$search_object = dbms_first
; Include IDF specific settings:
#file usysadm:idf.asn
[PATHS]
; Overwrite with my own paths:
$SOL = SOL:nmpipe SOLID:|user|pasword
$IDF = $SOL
$UUU = $SOL
$SYS = $SOL
$DEF = $DEF
[FILES]
; Overwrite with my own versions of udesc.urr and uobj.dol:
usys:uobj.dol = uobj.dol
usys:udesc.urr = udesc.urr
; Redirect Uniface files:
usys:*.* = usys:*.*
; Redirect my own files:
*.* = *.*
; End
例:idf.asn
ここでは、Uniface Web アプリケーションの開発とテスト用の基本的な構成を提供するアサインメ
ント ファイルの例を示します。
[SETTINGS] セクションでは、要求のたびに Uniface サーバー ページを強制的に再ロードするた
めに、設定 $testmode_components を指定します。
[FILES] セクションでは、uobj.dol、udesc.urr、および userver.aps のローカル バリエー
ションが使用されていることがインダイレクションによって示されています。WebApplication
サーバーのアサインメント ファイルでも同様のインダイレクションを行う必要があります。
WebApplication サーバーが実行時に使用するすべてのファイルは、ディレクトリ c:\wasvenv に
保存されます。
第 4 章 構成ファイル
73
; idf.asn
[SETTINGS]
; My local settings:
$putmess_logfile = myidf.log
$trc_start = myidf_trace.log
$search_descriptor = dbms_first
$search_object = dbms_first
$testmode_components
; Include IDF specific settings:
#file usysadm:idf.asn
[PATHS]
; Overwrite with my own paths:
$SOL = SOL:nmpipe SOLID:|user|pasword
$IDF = $SOL
$UUU = $SOL
$SYS = $SOL
$DEF = $DEF
[FILES]
; Overwrite with my own versions of udesc.urr, uobj.dol, and userver.aps:
usys:uobj.dol = c:\wasvenv\uobj.dol
usys:udesc.urr = c:\wasvenv\udesc.urr
usys:userver.aps = c:\wasvenv\userver.aps
; Redirect Uniface files:
usys:*.* = usys:*.*
; Redirect my own files:
*.usp = c:\wasvenv\*.usp
*.hts = c:\wasvenv\*.hts
*.svc = c:\wasvenv\*.svc
4.3.3 urouter.asn
Uniface ルーターのアサインメント ファイルです。urouter.asn ファイルを使用して、設定、コ
ネクタへのパス、Uniface サーバー環境定義(UST など)を指定できます。
プロパティ
◆
デフォルトの場所:UnifaceInstallDir\adm
ファイルのセクション
アサインメント ファイルには通常、以下のセクションが含まれています。
◆
74
[SETTINGS]
Uniface インストール/構成ガイド(iSeries 版)
◆
[SERVERS]
◆
[PRE_START]
アサインメント設定
[SETTINGS] セクションには、以下のようなアサインメント設定を含めることができます。
◆
$DEFAULT_NET
◆
$DEFAULT_TCPHOST
◆
$DNP
◆
$MAXCLIENTS
◆
$MAXMONS
◆
$MAXSERVERS
◆
$NET_TIMEOUT
コマンド ライン スイッチ
[SERVERS] セクションの UST 定義には、以下のようなコマンド ライン スイッチを含めることが
できます(ここに示すスイッチに限定されません)。
◆
/asn
◆
/dir
◆
/ex
◆
/gates
◆
/hostrc
◆
/max
◆
/maxreq
◆
/maxidle
◆
-nosu
◆
/pri
◆
/shr
◆
/su
例:urouter.asn
ここでは、一般的な urouter.asn ファイルの例を示します。[SETTINGS] セクションと
[SERVERS] セクションには、以下の内容が示されます。
◆
いくつかの Uniface サーバーの UST(サーバー名)。クライアントによる指定がなかった場合
に使用される、デフォルト サーバー DEFAULT も含まれています。
第 4 章 構成ファイル
75
◆
/gates スイッチと共に使用する /ex スイッチ。UST PAYROLL の例は、クライアントが
Uniface サーバーへの排他的接続を要求した場合に、その接続に選択されるポートは 3800 ~
3999(/gates)の範囲であることを指定しています。
◆
作業ディレクトリ(/dir)
◆
アサインメント ファイル(/asn)
◆
使用可能な Uniface アプリケーション サーバーの最大インスタンス数($MAXSERVERS と /
max)
◆
使用可能な Uniface ルーター モニタの最大インスタンス数($MAXMONS)
◆
実行可能な最大リクエスト数(/maxreq)。開発者環境の場合だけ、maxreq を 1 に設定しま
す。1 に設定していないと、古い HTS ファイルが常に表示されます。
◆
最大アイドル時間(/maxidle)
Windows
[SETTINGS]
$putmess_logfile = urouter.log
$MAXSERVERS = 500
; number of Uniface Application Servers allowed
$MAXMONS = 3
; number of Uniface Router Monitors allowed
[SERVERS]
DEFAULT = userver.exe /maxidle=2h /dir=..\home\guest
SALES = userver.exe /max=10 /asn=..\usr\local\sales\asv.asn /dir=..\home\kees
HR = userver.exe /max=50 /maxreq=100 /asn=..\usr\local\hr\asv.asn
PAYROLL = userver.exe /ex /gates=3800-3999 /asn=..\usr\secure\payrollasv.asn
UNIX、OpenVMS、および iSeries
[SETTINGS] セクションは上と同じです。[SERVERS] セクションは、以下のようになります。
[SERVERS]
DEFAULT = userver -maxidle=2h -dir=/home/guest
SALES = userver -max=10 -asn=/usr/local/sales/asv.asn -dir=/home/kees
HR = userver -max=50 -maxreq=100 -asn=/usr/local/hr/asv.asn
PAYROLL = userver -ex -gates=3800-3999 -asn=/usr/secure/payrollasv.asn
OpenVMS では、[SETTINGS] セクションと [SERVERS] セクションのスイッチは同じになります
が、ファイル名が VMS の規則に準じます。
[SERVERS]
[SERVERS] セクションでは、Uniface サーバーの名前(UST)を指定します。このセクションは、
Uniface ルーター アサインメント ファイル(urouter.asn)だけで使用されます。
76
Uniface インストール/構成ガイド(iSeries 版)
シンタックス
UST=Executable
{ApplicationShell}
{/CommandLineOption1/CommandLineSwitchn}
引数
◆
◆
UST ― サーバーの名前。デフォルトまたはフォールバック UST の名前は DEFAULT です。
Executable ― パスを含む Uniface サーバー実行可能ファイル(Microsoft Windows 上の
userver.exe など)
◆
CommandLineSwitch ― Uniface サーバー(UServer)を構成するためのコマンド ライン
スイッチとその値
iSeries では、各コマンド ライン スイッチを一重引用符で囲む必要があります。
◆
ApplicationShell ― スタートアップ シェルの名前(デフォルトは userver.aps)
スイッチ
標準のコマンド ライン スイッチを以下に示します(ただし、これらに限定されません)
。
◆
/dir
◆
/asn
◆
/pri
◆
/ex
◆
/gates
◆
/shr
◆
/su
◆
-nosu(Unix のみ)
メモ:Uniface ルーターのアサインメント ファイルで /ex スイッチを使用できますが、/ex ス
イッチはクライアントのアサインメント ファイル以外で使用しないことをお勧めします。
Uniface サーバーのスタートアップ スイッチを以下に示します。
◆
/max
◆
/maxreq
◆
/maxidle
第 4 章 構成ファイル
77
例:
以下のサンプル アサインメント ファイルは、Microsoft Windows 上の [SERVERS] セクションを
示しています。
[SERVERS]
DEFAULT = c:\uniface\bin\userver.exe /maxidle=2h /dir=..\project
SALES = c:\uniface\bin\userver.exe /asn=asv.asn /dir=..\home\kees /max=10 myaps
HR = c:\uniface\bin\userver.exe /asn=asv.asn /max=50 /maxreq=100
PAYROLL = c:\uniface\bin\userver.exe /asn=usysadm:payrollasv.asn
以下のサンプル アサインメント ファイルは、UNIX 上の同じ設定を示しています。
[SERVERS]
DEFAULT = /userver -maxidle=2h -dir=../project
SALES = /userver -asn=asv.asn -dir=../home/kees -max=10 myaps
HR = /userver -asn=asv.asn -max=50 -maxreq=100
PAYROLL = /userver -asn=usysadm:payrollasv.asn
[PRE_START]
[PRE_START] セクションでは、Uniface ルーターを自動的に起動する Uniface サーバーの名前
(UST)を指定します。
シンタックス
NetworkMnemonic:{HostID}|UserName|Password|UST{/ex|/shr}{/su|-nosu}
引数
t
◆
NetworkMnemonic - TCP などのネットワーク コネクタ用の 3 文字の Uniface ニーモニック
HostID ― ホストのネットワーク ノード名(オプション)
HostID フィールドは、その内容が Uniface ルーターで自動的に決定されるため、実際には使
用されません。HostID は空のままにすることができますが、以下のようなパイプ記号が必要
になります。
tcp:|user1|pass1|ust1
◆
UserName ― HostID にログオンするためのログオン名とその他のオペレーティング システム
固有の情報。Microsoft Windows では、以下のように追加のオプション情報に UserName を
チェックするためのドメイン名を含めることができます。
Mydomain\Me
◆
78
Password ― HostID にログオンするための UserName のパスワード
Uniface インストール/構成ガイド(iSeries 版)
◆
UST ― Uniface サーバー タイプ。事前起動する特定の Uniface サーバーの名前を指定します。
[SERVERS] セクションで宣言する必要があります。
スイッチ
◆
/ex
◆
/shr
◆
/su
◆
-nosu(Unix のみ)
説明
[PRE_START] セクションは、Uniface ルーター アサインメント ファイル(urouter.asn)内だ
けで使用されます。
例:
以下の例では、Uniface ルーターが、[PRE_START] セクションの 3 つの行で指定された 3 つの
サーバーを起動します。このうち 2 つのサーバーは、[SERVERS] セクションの user1 と user2 に
関する ust1 定義を使用して起動され、3 つめのサーバーは、user2 に関する ust2 定義を使用して
起動されます。
[PRE_START]
tcp:host|user1|pass1|ust1
tcp:host|user2|pass2|ust1
tcp:host|user2|pass2|ust2
[SERVERS]
ust1 = userver /asn=asn1.asn /dir=d:\dir1
ust2 = userver /asn=asn2.asn /dir=d:\dir2
[SETTINGS]
[SETTINGS] セクションには、アプリケーションの外観、I/O 動作、アプリケーションの環境設定、
テスト、互換性設定などの Uniface アプリケーションを制御する設定が含まれています。
シンタックス
Setting{{=}Value}
引数
◆
Setting ― 設定の名前
第 4 章 構成ファイル
79
◆
Value ― 設定の値。指定されなかった場合は、デフォルト値が使用されます。デフォルト値
については、それぞれのアサインメント設定を参照してください。
説明
特定の設定に関する詳細については、「構成設定:アサインメント」を参照してください。
例:
以下のサンプル アサインメント ファイルでは、一連の設定値が指定されます。
[SETTINGS]
$CENTURY_BREAK = 05
$SEARCH_DESCRIPTOR = DBMS_FIRST
$SEARCH_OBJECT = DBMS_FIRST
$PUTMESS_LOGFILE = idf.log
4.3.4 wasv.asn
wasv.asn ファイルは、Web アプリケーション サーバーの基本アサインメント ファイルです。
プロパティ
◆
デフォルトの場所:UnifaceInstallDir\adm
説明
wasv.asn ファイルは Uniface のインストール中に作成されます。デフォルトの urouter.asn
ファイルで定義されているように、Web アプリケーション サーバーはこのアサインメント ファイ
ルを使用してリモート ブラウザの USP 要求に応答します。
wasv.asn ファイルには、コードベースやログファイル定義といった、WASV 固有の設定のみが含
まれます。データベースへのパスのリダイレクション用に、dbms.asn ファイルが含まれていま
す。これは、デフォルトで SOLID 開発データベースを指します。
このファイルは、それぞれの環境に合わせて修正できます。
4.3.5 web.xml
Web アプリケーションの構成ファイルです(Uniface Web アプリケーション サーバーと混同しな
いでください)。
◆
デフォルトの場所:UnifaceInstallDir\apache-tomcatVersionNumber\webapps\uniface\WEB-INF
80
Uniface インストール/構成ガイド(iSeries 版)
説明
web.xml ファイルには、Java ベースの Web サーバーで使用される Web Application Deployment
Descriptors が含まれます。Uniface サーブレットは、Web Application の環境内で実行されます。
WRD、SRD、TestWRD サーブレットといった Uniface サーブレットの設定は、web.xml ファイ
ルに保管されます。
設定
サーブレットの設定は、サーブレットごとに 1 つのサーブレット設定セクションにグループ化され
ます。web.xml ファイルでは、以下のフォーマットでサーブレット設定を指定します。
<web-app>
<servlet>
<servlet-name>ServletName</servlet-name>
<servlet-class>ServletClass</servlet-class>
<init-param>
<param-name>ParamName<param-name>
<param-value>ParamValue<param-value>
</init-param>
...
</servlet>
</web-app>
各項目の内容は以下のとおりです。
◆
ServletName — サーブレットの名前です(たとえば、Uniface サーブレット wrd、srd、
testwrd など)。
◆
ServletClass — サーブレットを実装する Java クラスです。
◆
ParamName — SRD サーブレット構成設定の名前です。
◆
ParamValue — 設定の値です。
表 4-3. サーブレット設定
パラメータ
説明
ASVTIMEOUT
ASVTIMEOUT (SRD)
サーブレットで Uniface サーバーからの返信や確認応答を待機する
秒数を指定します。
AUTHORIZATION
ユーザー権限が必要なサーブレットを指定します。
DEFAULTENCODING
受信 HTML と送信 HTML の変換に使用するデフォルトのエンコー
ドを指定します。
第 4 章 構成ファイル
81
表 4-3. サーブレット設定
パラメータ
説明
ERRORDIR
Web エラー メッセージ ページの親ディレクトリのパスを指定しま
す。
MAXFILEUPLOADSIZE
クライアントからサーバーへアップロードできるファイルの最大
サイズをキロバイト単位で指定します。
MAXFILEUPLOADS
1 つのクライアント セッションでアップロードできるファイルの
最大数を指定します。
MIDDLEWARE
使用するミドルウェア モジュールと Uniface サーバー ホストを指
定します。
MIDDLEWARE (SRD)
RESOURCEDIR
ダウンロード可能なリソースを一時的に保存するディレクトリを
指定します。
RESOURCETIMEOUT
ダウンロード可能なリソースがサーバーから削除される前に、
サーブレットでそれらのリソースをキャッシュする最大時間を秒数
で指定します。
SESSIONCOOKIE
クライアントで cookie を設定できるかどうかを指定します。デ
フォルト値は TRUE です。dynamic に設定した場合、サーブレッ
トによって、ブラウザで cookie を受け入れることができるかどう
かが決定されます。
TESTABLE
USP をテストするかどうかを指定する値ブール値と情報ページを
表示します。デフォルト値は TRUE です。
USERUNPREFIX
WRD で相対パスによるドキュメントへの参照を処理することを指
定します。WRD Java サーブレットでは、css/applic.css などの要求
を WRD サーブレットのルートや WEBAPPURL の設定値にリダイ
レクトします。
WEBAPPURL
サーブレットの Web アプリケーション ディレクトリの絶対 URL
パスを指定します。
ファイルのセクション
82
◆
SRD サーブレット
◆
WRD サーブレット
◆
TESTWRD サーブレット
Uniface インストール/構成ガイド(iSeries 版)
4.4 アサインメント設定
4.4.1 $DNP
Uniface ルーターのデフォルトのネットワーク パスを指定します。
シンタックス
$DNP{=}Protocol:{HostID}{+PortNumber}{|||ClientID}
説明
Uniface ルーターのデフォルトのネットワーク パスを指定します。このパスは、DNP(Default
Network for Postmessage)とも呼ばれます。この設定は、Uniface ルーターにクライアントと
サーバーの両方を登録する際に便利です。
引数は以下のとおりです。
◆
◆
Protocol: はネットワーク プロトコルです。
HostID はルーターを実行しているホスト マシンの識別子です。省略すると、デフォルトの
localhost が使用されます。
HostID のフォーマットにより、使われる TCP プロトコルのバージョンが決まりま
す。詳細については、Uniface ライブラリの「TCP/IPv6」を参照してください。
◆
PortNumber は指定したホストのポート番号です。省略すると、デフォルト値の 13001 が使用
されます。
◆
ClientID は、ルーターに Uniface クライアントを登録する際に使用され、Uniface クライア
ントの論理 ID を表します。また、コマンド ライン スイッチ /ust を使用して論理クライアン
ト ID を指定することもできます。
$DNP の設定で ClientID を省略する場合は、/dnp または /ust、または PROC ステートメント
"open ...|||ClientID" を使用して指定する必要があります。
$DNP の使用例:
$DNP = TCP:mammal+13002|||tiger
この例では、デフォルト プロトコルを TCP とし、mammal サーバーのポート 13002 に接続し、
クライアント ID は tiger となります。ユーザーは実行時に、ユーザー名とパスワードを入力するよ
う求められます。
4.4.2 $MAXCLIENTS
Uniface ルーターが受け入れ可能なクライアントの最大数を指定します。
第 4 章 構成ファイル
83
シンタックス
$MAXCLIENTS {=} NumberOfClients
引数
NumberOfClients — Uniface ルーターが受け入れ可能なクライアントの最大数です。
説明
デフォルトでは、Uniface ルーターが受け入れられるクライアント数に制限はありません。
この設定は、urouter.asn ファイルの [SETTINGS] セクションにあります。
4.4.3 $MAXSERVERS
Uniface ルーターが起動できる Uniface サーバーの最大数を指定します。
シンタックス
$MAXSERVERS = NumberOfServers
引数
NumberOfServers — Uniface ルーターが起動できる Uniface サーバーの最大数です。
説明
デフォルトでは、Uniface ルーターが受け入れられる Uniface サーバー数に制限はありません。
この設定は、urouter.asn ファイルの [SETTINGS] セクションにあります。
4.4.4 $MAXMONS
Uniface ルーターが受け入れ可能な Uniface ルーター モニタの最大数を指定します。
シンタックス
$MAXMONS {=} NumberOfMonitors
引数
NumberOfMonitors — Uniface ルーターが受け入れ可能な Uniface ルーター モニタの最大数で
す。
説明
デフォルトでは、Uniface ルーターが受け入れられる Uniface ルーター モニタ数に制限はありませ
ん。
この設定は、urouter.asn ファイルの [SETTINGS] セクションにあります。
84
Uniface インストール/構成ガイド(iSeries 版)
4.4.5 $PUTMESS_LOGFILE
メッセージ フレームの内容をファイルにコピーします。
シンタックス
$PUTMESS_LOGFILE {=} Filename{%p} {/append}
$PUTMESS_LOGFILE {=} {"}NONE{"}
引数
◆
◆
Filename — 出力ログ ファイルのフル パス名です。最大長は 64 文字です
%p — 起動されたアプリケーションのプロセス ID に基づいた名前を持つ個別のログ ファイル
を指定します。%p を指定すると /append が無視されます。
◆
/append — すべてのメッセージ フレーム情報を、指定した Filename に追加します。これ
は、2 つのセッションが、同時に、または連続的に起動された場合に便利です。ファイルには、
両方のセッションのログ情報が挿入されます。/append を使用しないと、ファイルには最後の
セッションのログ情報のみが挿入されます。
◆
NONE — Uniface ルーター プロセスまたは Uniface サーバー プロセスのログ ファイルを作成し
ません。指定する場合は大文字を使用します。
説明
$PUTMESS_LOGFILE は、アプリケーションのメッセージ フレーム情報のコピーを、ログ ファイル
Filename に送ります。このファイルには、メッセージ フレームに対するすべての出力の完全な
記録が保存されます。メッセージ フレームがクリアされてもファイルはクリアされません。このた
め、大きなアプリケーションが実行されている場合はログ ファイルが非常に大きくなる可能性があ
ります。
アプリケーションがこのアサインメントを使用して起動されたときにすでに Filename が存在し
ていた場合は、その内容はクリアされます。
Filename の 1 行めには、セッションが開始された日付と時刻が含まれます。日付は、 yyyymm-dd 形式で表示されます。たとえば、2006 年 11 月 24 日は、2006-11-24 となります。
メモ:$PUTMESS_LOGFILE は、開発とテストだけで使用することを推奨します。実稼働環境で
使用すると、大きなログ ファイルが多数作成されて、貴重なディスク リソースを消費してしま
います。
第 4 章 構成ファイル
85
複数のサーバー プロセスのログ ファイル
Uniface ルーターまたは Uniface サーバーの場合、複数のサーバー プロセスが同時に実行される場
合があるため、$PUTMESS_LOGFILE を指定しなくても、デフォルトで常に、ルーターおよびサー
バーの各インスタンスに固有のログ ファイルが作成されます。
Uniface ルーターまたはサーバーのログ ファイルを作成したくない場合は、適切なアサインメント
ファイル内で $PUTMESS_LOGFILE に NONE オプションを指定して、作成を抑制してください。
$PUTMESS_LOGFILE=myapp%p.log
この例では、実行しているアプリケーションのプロセス ID が 214 の場合、ログ ファイル名は
myapp214.log となります。
86
Uniface インストール/構成ガイド(iSeries 版)
第 5 章 実行可能ファイルと
スイッチ
5.1 urouter
Uniface ルーターの実行可能ファイルです。
シンタックス
urouter{/inst=...}{/stop|/shut=...}{/rem=...}{/show=...}{asn=AssignmentFile}
スイッチ
◆
/inst(Windows のみ)
◆
/stop(および /shut)
◆
/rem(Windows のみ)
◆
/show(Windows のみ)
◆
/asn— アサインメント ファイルのパスと名前です。指定しない場合、デフォルトは
InstallationDirectory\adm\urouter.asn になります。
説明
この実行可能ファイルを使用して、Uniface ルーターを起動または停止するか、サービスとしての
Uniface ルーターを削除します。デフォルトでは、bin サブディレクトリに配置されています。
サービスをサポートする Microsoft Windows オペレーティング システムでは、複数の Uniface
ルーターを別個のサービスとしてインストールできます。各サービスは、/inst コマンド ライン
スイッチを使用して、固有のサービス名で登録されます。
5.2 userver
Uniface サーバーの実行可能ファイルで、USYSBIN:(\bin)サブディレクトリに配置されていま
す。
シンタックス
userver{/ust=...}{/dnp=...}{/drv=...}{/dir=...}
87
スイッチ
◆
/ust
◆
/dnp
◆
/drv
◆
/dir
説明
urouter.asn ファイルに UST を定義するとき、または手動で Uniface サーバーを起動するとき
に、この実行可能ファイルとコマンド ライン スイッチを指定します。
Uniface ルーターが 13001 以外のポートをリスンするときは、/dnp コマンド ライン スイッチを使
用してポートを指定します。または、usys.asn またはサーバー アサインメント ファイルに $DNP
または $DEFAULT_NET を定義します。
5.3 コマンド ライン スイッチ
5.3.1 /asn
アプリケーションが使用するアサインメント ファイルを指定します。
シンタックス
/asn=FileName
説明
FileName からアサインメントを使用してアプリケーションを実行します。ファイルの完全なパス
名を指定できます。
/asn スイッチで指定されたファイルは、スタートアップ シェルのアサインメント ファイル エント
リと Shell.asn で指定されたデフォルトのアサインメント ファイルの両方を上書きします。
Uniface は FileName で指定されたファイルを、まずコマンド ラインに入力されたとおりに、次に
小文字で、最後は大文字で検索します。ファイルが見つからず、FileName が拡張子を含んでいな
い場合、拡張子 .asn が追加され、検索が繰り返されます。
/asn スイッチを使用してスタートアップ シェルと同じ名前(Shell.asn)のアサインメント
ファイルを指定する場合、拡張子 .asn を必ず付けてください。この拡張子を付けないと、Uniface
はスタートアップ シェル Shell を検索し、それをアサインメント ファイルとして使おうとしま
す。
以下の例では、アサインメントはカレント ディレクトリのファイル another.asn にあります。
/asn=another
88
Uniface インストール/構成ガイド(iSeries 版)
5.3.2 /dnp
Uniface ルーターのデフォルトのネットワーク パスを指定します。
シンタックス
/dnp=Protocol:{HostID{+PortNumber}}{|||ClientID}
パラメータ
◆
Protocol はネットワーク プロトコルです。
◆
HostID はルーターを実行しているホスト マシンの識別子です。省略すると、デフォルトの
localhost が使用されます。
HostID のフォーマットにより、使用する TCP プロトコルのバージョンが決まります。
◆
PortNumber は指定したホストのポート番号です。省略すると、デフォルト値の 13001 が使用
されます。
◆
Uniface ルーターに Uniface クライアントを登録する際に使用した場合、 ClientID は
Uniface クライアントの論理 ID になります。また、コマンド ライン スイッチ /ust を使用し
て論理クライアント ID を指定することもできます。
説明
Uniface ルーターのデフォルトのネットワーク パスを指定します。このパスは、DNP(Default
Network for Postmessage)とも呼ばれます。この設定は、Uniface ルーターにクライアントと
サーバーの両方を登録する際に便利です。
/dnp スイッチが省略され、アサインメント ファイル設定の [PATHS] セクションに $DNP がなく、
[SETTINGS] セクションに $DEFAULT_NET 設定がない場合、デフォルトの DNP は、localhost の
ポート 13001 の TCP になります。
ClientID が /dnp コマンド ライン スイッチと $DNP 設定の両方で指定されている場合、/dnp
の ClientID は、$DNP の設定より優先されます。
以下の例では、TCP ポート 13002 が、fringe ホスト上の Uniface ファイル サーバーのデフォルト
ネットワーク パスであることを指定しています。
userver.exe /dnp=TCP:fringe+13002 /drv=FIL
以下の例では、TCP ポート 13002 が、mammal ホスト上の Uniface クライアント tiger のデフォ
ルト ネットワーク パスであることを指定しています。
uniface.exe /dnp=TCP:mammal+13002|||tiger
myapp.aps
第 5 章 実行可能ファイルとスイッチ
89
5.3.3 /dir
Uniface アプリケーションの作業ディレクトリを指定します。
シンタックス
/dir=WorkingDirectory
説明
指定した作業ディレクトリを使用してアプリケーションを実行します。ディレクトリのフル パス名
を指定できます。パスにスペースが含まれている場合は、フル パス名を二重引用符で囲みます。
Uniface ルーターを使用する
Microsoft Windows NT では、Uniface ルーターはコマンド ラインで /dir スイッチを使用して起動
できます。または NT サービス([ コントロール パネル ]>[ サービス ])として、[Startup
Parameters] フィールドで /dir を指定して起動できます。[Startup Parameters] フィールドを使
用する場合の NT の動作で、バックスラッシュは削除されます。パスを指定する際ディレクトリの
区切りには、バックスラッシュを 2 つ、またはスラッシュを 1 つのどちらでも使用できます。たと
えば、パス c:\uniface\project には、以下の /dir スイッチのいずれか 1 つかを指定する必要
があります。
/dir=c:\\uniface\\project または /dir=c:/uniface/project
/dir スイッチは、Uniface ルーター アサインメント ファイル(urouter.asn)の [SERVERS]
セクションでも使用でき、特定の Uniface サーバー名(UST)の作業ディレクトリを指定できま
す。サーバーの作業ディレクトリが urouter.asn から決定できない場合、ルーターと同じデフォ
ルトが使用されます。
Uniface デプロイメント ユーティリティを使用する
/dir コマンド ライン スイッチを使用して、デプロイメント ユーティリティのカレント作業ディレ
クトリを設定します。
/dir コマンド ライン スイッチには、/uar コマンド ライン スイッチを指定する必要があります。
5.3.4 /ex
Uniface ルーターがクライアントから Uniface サーバーへの排他的接続を作成するように指定しま
す。
シンタックス
/ex
90
Uniface インストール/構成ガイド(iSeries 版)
説明
クライアントのアサインメント ファイルで /ex スイッチを使用して、Uniface ルーターがクライア
ントから Uniface サーバーへの排他的接続を作成するように指定します。デフォルトでは、
Uniface ルーターは共有サーバーを起動します。
UNIX では、/gates スイッチを明示的に指定しないと、Uniface ルーターによって起動された排
他サーバーは、Uniface ルーターからクライアントへの接続を継承し、Uniface ルーターと同じ
ポート番号を使用します。
その他のプラットフォームでは、Uniface ルーターによって起動された排他サーバーは新しいリス
ン ポートを作成し、このポート番号を Uniface ルーターに渡します。その後、このポート番号はク
ライアントに渡されます。
いずれの場合も、クライアントは Uniface ルーターから切断し、ポート上で直接起動されたサー
バーに再び接続します。Uniface ルーターは、クライアントからの要求を送信しなくなります
以下のどちらかの場所で、/ex スイッチを使用します。
◆
クライアントのアサインメント ファイルのパス宣言。こちらを推奨します。
◆
Uniface ルーターのアサインメント ファイル urouter.asn にある [SERVERS] セクションで
の UST のパス宣言。
メモ:Uniface ルーターのアサインメント ファイルで /ex スイッチを使用できますが、/ex ス
イッチはクライアントのアサインメント ファイルだけで使用することをお勧めします。
表 5-1. クライアントと Uniface ルーターのアサインメント ファイル内の /ex と /shr の効果
クライアント側の特定の UST に対する /ex スイッチは、Uniface ルーターのアサインメント ファ
イル内にその UST に対応する /shr スイッチが存在しない場合にだけ機能します。クライアント
のアサインメント ファイル内で指定されたスイッチが、Uniface ルーターのアサインメント ファイ
ル内で指定されたスイッチと異なる場合は、クライアント側のスイッチが無視され、警告メッセー
ジが生成されます。
URouter.asn
スイッチなし
/ex
/shr
第 5 章 実行可能ファイルとスイッチ
91
Client.asn
スイッチな
し
共有(デフォル
ト)
排他
共有
/ex
排他
排他
共有 + 警告メッセー
ジ
/shr
共有
排他 + 警告メッセー
ジ
共有
ファイアウォール
/ex スイッチを使用すると、ファイアウォールの使用に影響があります。
◆
UNIX の場合、前述の継承が行われるため、Uniface ルーターによって使用されるポート番号
だけがファイアウォールを通って使用可能になる必要があります。
◆
その他のプラットフォームでは、/gates スイッチを使用して、排他接続で使用するポート範
囲を指定する必要があります。このようにすることで、それらのポートがファイアウォールを
通って使用できるようになります。
◆
クライアントとサーバーの間で NAT(ネットワーク アドレス変換)ファイアウォールを使用
する場合、Uniface ルーターのアサインメント ファイルの UST 宣言に /hostrc スイッチを使
用して、クライアントへの再接続に使用するホスト名(IP アドレスでなく)を指定することが
必要です。
5.3.5 /gates
TCP 経由で排他的サーバーを起動するために、検索するポートの範囲を指定します。
シンタックス
/gates=PortFrom-PortTo
説明
UST 宣言と一緒に /gates スイッチを使用すると、TCP 経由で排他的サーバーを起動する際に、
Uniface ルーターによって検索されるポート範囲を指定できます。
PortFrom と PortTo は 10 進数のポート番号で、 PortFrom は PortTo 未満である必要があ
りますが、その他のチェックは実行されません。指定エラーが発生した場合、Uniface ルーターの
ログ ファイルにレポートされ、接続は行われません。ポートが指定された範囲で見つからない場
合、エラーがクライアントにレポートされます。
/gates スイッチは以下のように使用できます。
◆
92
サーバーへの排他接続の場合のみ(/ex コマンド ライン スイッチを参照)
Uniface インストール/構成ガイド(iSeries 版)
◆
TCP 上でのみ
◆
Uniface ルーターのアサインメント ファイルの [SERVERS] セクションでのみ
◆
UST 宣言でのみ
例:
[SERVERS]
; optional default server
default = userver /dir=/home/xxx
sales
= userver /ex /gates=3800-4010 /hostrc
local
= userver /maxidle=600
メモ:ファイアウォール使用についての重要な情報は、「/ex」を参照してください。
5.3.6 /hostrc
Uniface サーバーへの再接続に使用するホスト名を指定します。
構文
/hostrc
同時使用
/ex
説明
Uniface ルーターのアサインメント ファイルの UST 宣言で /hostrc スイッチを使用して、クライ
アントが TCP 経由で排他サーバーに再接続するときに使用するホスト名(IP アドレスではなく)
を指定します。
このスイッチは、NAT(ネットワーク アドレス変換)ファイアウォールで使用されます。NAT
ファイアウォールでは、Uniface サーバーの変換されていない IP アドレスはクライアントに対して
使用されないため、ホスト名を使用する必要があります。
/hostrc スイッチは以下のように使用できます。
◆
サーバーへの排他接続の場合のみ(/ex コマンド ライン スイッチを参照)
◆
TCP 上でのみ
◆
Uniface ルーターのアサインメント ファイルの [SERVERS] セクションでのみ
◆
UST 宣言でのみ
例:
[SERVERS]
sales = userver.exe /ex /hostrc
第 5 章 実行可能ファイルとスイッチ
93
メモ:Unix では、/hostrc スイッチは効果がありません(/gates スイッチと一緒に指定した
場合を除きます)。
5.3.7 /max
Uniface ルーターが起動できる共有 Uniface サーバーのインスタンスの最大数を指定します。
シンタックス
/max=MaxServers
説明
/max スイッチは Uniface ルーターのアサインメント ファイル urouter.asn の [SERVERS] セク
ションで使用して、ルーターがユーザーごとのサーバー名(UST)に対して開始できる、共有サー
バー インスタンスの最大数を指定します。/max スイッチは共有サーバーだけで意味を持ちます。
ルーターは、UST、OS アカウント、サーバー ロール、ログオン設定など、完全な指定を比較する
ことにより、サーバー数をカウントします。/max=1 を指定しても、1 つのサーバー プロセスのみ
が実行を許可されるという意味にはなりません。これを省略すると、デフォルト値の -1 が使用され
ます。これは無制限という意味です。/max=0 を指定すると、サーバーは起動されず、エラーがク
ライアント j に送信されます。この指定は、サーバーを保守のために無効にする場合に使えます。
urouter.asn の例を参照してください。
5.3.8 /maxidle
共有 Uniface サーバーがアイドル状態でいられる最大時間を指定します。
構文
/maxidle=MaxIdleTime{TimeUnit}
説明
/maxidle スイッチは Uniface ルーターのアサインメント ファイル urouter.asn の [SERVERS]
セクションだけで使用して、サーバー名(UST)で識別される共有サーバーが、アイドル状態でい
られる最大時間(リクエストを処理しない時間)を指定します。
これを省略すると、 MaxIdleTime のデフォルト値は -1 で、無限の時間を意味します。指定する
場合、 MaxIdleTime の値は自然数である必要があります。
オプションの TimeUnit(単位)は以下のいずれかです。
◆
94
s — 秒(TimeUnit を省略した場合のデフォルト)
Uniface インストール/構成ガイド(iSeries 版)
◆
m—分
◆
h — 時間
◆
d—日
◆
w—週
時間の単位は、/maxidle=4w2d のように組み合わせて指定することはできません。
サーバー ロールに対応する以下の条件が「TRUE」の場合にだけ、サーバーは停止します。
◆
開いているファイルがない
◆
開いているデータベース トランザクションがない
◆
開いているコンポーネント インスタンスがない
関連情報 urouter.asn の例を参照してください。
5.3.9 /maxreq
共有 Uniface サーバーが実行できる要求の最大数を指定します。
シンタックス
/maxreq=MaxRequests
説明
/maxreq スイッチは Uniface ルーターのアサインメント ファイル urouter.asn の [SERVERS] セ
クションで使用して、サーバー名(UST)で識別される共有サーバーが実行できる、要求の最大数
を指定します。/maxreq スイッチは共有サーバーだけで意味を持ちます。
サーバー ロールに対応する以下の条件が「TRUE」の場合にだけ、サーバーは停止します。
◆
開いているファイルがない
◆
開いているデータベース トランザクションがない
◆
開いているコンポーネント インスタンスがない
これを省略すると、デフォルト値の -1 が使用されます。これは無制限という意味です。/
maxreq=0 を指定すると、サーバーは起動されず、エラーがクライアントに送信されます。この指
定は、サーバーを保守のために無効にする場合に使えます。
urouter.asn の /maxreq は、開発環境では 1 に設定してください。1 に設定していないと、古い
HTS ファイルが常に表示されます。
5.3.10 /pri
メッセージ フレームまたはログ ファイルに送信する I/O メッセージを選択します。
シンタックス
/pri=Value
第 5 章 実行可能ファイルとスイッチ
95
説明
メッセージ フレームまたはログ ファイルに送信する I/O メッセージを選択します。このスイッチで
指定した Value は、スタートアップ シェル定義内のエントリを上書きします。以下の表の希望す
るメッセージ コードを合計して、Value を決めます。
表 5-2. I/O メッセージ コード
コード
説明
1
Store シーケンス メッセージ。「メッセージ レベル 1:Store シーケンス メッセージ」
を参照。
2
コネクタ要求。「メッセージ レベル 2:DBMS コネクタ要求」を参照。
4
Fetch および Select のコネクタ要求からの戻り値。「メッセージ レベル 4:Fetch
および Select のコネクタ要求からの戻り値」を参照。
8
Open コネクタ要求からの説明。「メッセージ レベル 8:Open コネクタ要求から
の説明」を参照。
16
where 句および orderby 句からの説明。「メッセージ レベル 16:Where 句およ
び Order By 句の説明」を参照。
32
生成された SQL(ある場合)。「メッセージ レベル 32:生成された SQL」を参
照。
64
Uniface がオペレーティング システムに送信するすべてのシステム コール。
「メッセージ レベル 64:Uniface がオペレーティング システムに送信するすべて
のシステム コール」を参照。
128
UOBJ へのすべてのコールと送信されたデータ。「メッセージ レベル 128:UOBJ
へのすべてのコールと送信されたデータ」を参照。
256
URR ファイル、ULANA ファイル、または USYSANA ファイル内の記述子へのす
べてのコール。「メッセージ レベル 256:URR ファイル、ULANA ファイル、ま
たは USYSANA ファイル内の記述子へのすべてのコール」を参照。
512
すべての起動
1024
ネットワーク メッセージ
2048
PNG イメージ ローダー情報
0 を指定すると、Uniface からの I/O メッセージが抑制されます。この場合、メッセージ フレーム
はクリアされません。
96
Uniface インストール/構成ガイド(iSeries 版)
記述子情報以外のすべてのメッセージを要求するには、255(=1+2+4+8+16+32+64+128)を指定
します。
メッセージ フレームに表示されるメッセージを選択する機能は、開発プロセスでは大変便利です。
ただし、この情報を生成すると、アプリケーションのパフォーマンスが低下します。そのため、実
稼働環境ではメッセージを無効にすることをお勧めします。特に問題がありそうな場合だけ、メッ
セージを使用してください。
例:コマンド ライン スイッチ /pri
以下の例では、すべての Store シーケンス メッセージ(コード =1)、コネクタ関数コール(コード
=2)、Fetch および Select の戻り値(コード =4)、Open 説明ブロック(コード =8)をメッセージ
フレームに表示するよう要求します。希望するコードの合計(1+2+4+8)を、要求する value に指
定します。
/pri=15
5.3.11 /shr
Uniface ルーターがクライアントと Uniface サーバー間の接続を管理するように指定します。
シンタックス
/shr
説明
アサインメント ファイルで特定の UST に対して /shr スイッチを使用して、Uniface ルーターが
クライアントと Uniface サーバー間の接続を管理するように指定します。これは Uniface ルーター
のデフォルトの動作です。
/shr には、/ex スイッチと反対の効果があります。Uniface ルーターのアサインメント ファイルで
特定の UST に対して /shr スイッチを使用すると、クライアント サイドからの排他接続要求(/ex)
を上書きできます。
/shr スイッチは、クライアントのアサインメント ファイルで使用することもできますが、効果は
ありません。
表 5-3. クライアントと Uniface ルーターのアサインメント ファイル内の /ex と /shr の効果
クライアント側の特定の UST に対する /ex スイッチは、Uniface ルーターのアサインメント ファ
イル内にその UST に対応する /shr スイッチが存在しない場合にだけ機能します。クライアント
のアサインメント ファイル内で指定されたスイッチが、Uniface ルーターのアサインメント ファイ
第 5 章 実行可能ファイルとスイッチ
97
ル内で指定されたスイッチと異なる場合は、クライアント側のスイッチが無視され、警告メッセー
ジが生成されます。
URouter.asn
Client.as
n
スイッチなし
/ex
/shr
スイッチな
し
共有(デフォル
ト)
排他
共有
/ex
排他
排他
共有 + 警告メッセー
ジ
/shr
共有
排他 + 警告メッセー
ジ
共有
5.3.12 /su
ユーザーの環境で Uniface サーバーを起動するように Uniface ルーターに指示します。
シンタックス
/su
説明
/su スイッチは、スタートアップ時に Uniface サーバーの環境をログオン ユーザーの環境に設定す
るよう Uniface ルーターに指示します。
ログオンの動作は、UNIX、Windows、VMS でそれぞれ異なります。
◆
Microsoft Windows プラットフォームでは、/su スイッチによって、Uniface サーバーはユー
ザーの環境で起動します。この環境がない場合、Windows の使用前に環境が作成されます。/
su スイッチを指定しないと、Uniface サーバーは Uniface ルーターの環境を使用します。
◆
UNIX では、Uniface ルーターは /bin/su コマンドを使用して Uniface サーバーを起動します。
profile を使用して完全なユーザー ログオンが実行されます。/su スイッチを指定しないと、
Uniface サーバーはユーザーのユーザー ID とグループ ID を取得しても、環境は Uniface ルー
ターの環境になります。セキュリティ上の理由などで bin/su コマンドを使用できない場合に、
-nosu コマンド ライン スイッチを使用します。
◆
VMS では、/su スイッチがあってもなくても、Uniface サーバーは常にログオンを実行します
(login.com を使用して)。
以下の場所で /su スイッチを使用します。
◆
Uniface ルーターのアサインメント ファイル urouter.asn にある [SERVERS] セクションで
の UST のパス宣言
◆
98
クライアントのアサインメント ファイルのパス宣言
Uniface インストール/構成ガイド(iSeries 版)
メモ: Microsoft Windows で、Uniface サーバーから COM、SOAP、または Web サービスを呼
び出すには、Uniface ルーターのアサインメント ファイルにある Uniface サーバーの UST で /
su スイッチを使用して、パーミッションの問題が発生するのを防ぐ必要があります。
5.3.13 /ust
Uniface ルーターにクライアントまたはサーバーを登録します。
シンタックス
/ust=USTName
パラメータ
USTName — 特定のクライアント(クライアント ID)または UST(サーバー名)を識別する文字
列です。USTName には、英数字、ダッシュ、アンダスコアが使えます。コロン、スラッシュ、ドッ
ト、かっこなどは使えません。
説明
/ust コマンド ライン スイッチを使用して、Uniface クライアントまたはマニュアルで実行する
Uniface サーバーを、Uniface ルーターに登録できます。
クライアントの登録
Uniface クライアントは、ルーターに登録しないとメッセージを受信できません。登録では、
Uniface ユーザーの論理クライアント ID をルーターに提供する必要があります。この /ust コマン
ド ライン スイッチを使用して登録します。USTName には、Uniface クライアントを識別する文字
列(論理クライアント ID)を指定します。
メモ: /ust スイッチで指定したクライアント ID は、$DNP にクライアント ID がある場合、
それを上書きします。
例:コマンド ライン スイッチ /ust(クライアント登録)
以下の例では、Uniface ルーターに Uniface クライアントを登録する /ust コマンド ライン ス
イッチを使用して、Uniface アプリケーションを起動します。
Windows
uniface.exe /ust=unikees appl.aps
第 5 章 実行可能ファイルとスイッチ
99
UNIX
uniface /ust=unikees appl.aps
サーバーの登録
手動で開始された Uniface サーバーの場合、USTName が、この Uniface サーバーの特定のインス
タンス(ルーターのアサインメント ファイル urouter.asn の [SERVERS] セクションで定義され
る DATA など)のサーバー名(UST)を識別します。
UST がルーター アサインメント ファイルの [SERVERS] セクションで定義されていない場合、ま
たは /ust コマンド ライン スイッチが使用されていない場合、ルーターは「デフォルト サーバー」
で指定された制御スイッチを使用します。デフォルト サーバーが指定されていない場合、サーバー
はすべての標準デフォルト設定を使用して起動します。つまり、/dir はルーターの作業ディレク
トリと同じになります。/asn は usysadm:userver.asn で、/max、/maxreq、/maxidle は無
制限になります。
例:コマンド ライン スイッチ /ust(サーバー登録)
以下の例では、Uniface サーバーをマニュアルで起動し、それを Uniface ルーターに登録していま
す。/ust コマンド ライン スイッチは、ルーターのアサインメント ファイル urouter.asn でい
くつかのスイッチが指定されている、サーバー名 HOME を指定しています。
Windows
コマンドラインで、以下のように指定します。
userver.exe /ust=HOME
urouter.asn は、以下のようになります。
[SERVERS]
default = c:\usys82\userver.exe /max=10 /maxidle=2h
HOME = c:\usys82\userver.exe /asn=home\home.asn /dir=c:\usys82\project
UNIX
コマンドラインで、以下のように指定します。
userver /ust=HOME
urouter.asn は、以下のようになります。
[SERVERS]
default = /usys82/userver /max=10 /maxidle=2h
HOME = /usys82/userver /asn=/home/home.asn /dir=/usys82/project
100
Uniface インストール/構成ガイド(iSeries 版)
日本コンピュウェア株式会社テクニカル・サポートのご案内
オンライン・サポート・サイト FrontLine Japan
コンピュウェアの製品およびサポートに関する追加情報は、FrontLine Japan で提供されていま
す。
http://frontlinej.compuware.co.jp
FrontLine Japan のご利用には事前のユーザー登録が必要です。製品、サポートに関する重要な情
報も配信されますので、是非この機会にご登録ください。
テクニカル・サービスデスク
営業時間 月~金 9:00 ~ 18:00 ( 祝祭日、弊社休業日は除く)
コンピュウェア製品の利用に関しての技術的な質問やサポートに対するお問い合わせ窓口として、
テクニカル・サービスデスクを設置しています。
お問い合わせの際は、FrontLine Japan のお問い合わせフォームをご利用ください。緊急時には、
フリーダイヤル 0120-188-540 までお電話ください。
テクニカル・サポートの詳しい内容は、FrontLine Japan をご覧ください。
101
102
Uniface インストール/構成ガイド(iSeries 版)
Fly UP