このドキュメントでは、z/VSE オペレーティングシステム環境で Adabas システムファイルを使用して Natural をインストールする方法を順を追って説明します。
以下のトピックについて説明します。
Natural の『オペレーション』ドキュメントの「z/VSE 環境」も参照してください。
Unicode およびコードページサポートのインストール関連情報については、『Unicode およびコードページのサポート』ドキュメントの「Unicode／コードページ環境の設定と管理」を参照してください。
vrs または vr の表記について：このドキュメントでは、vrs または vr は、対応するバージョン、リリース、およびシステムメンテナンスレベル番号を表します。 製品バージョンの詳細については、『用語集』の「バージョン」を参照してください。
サポートされるバージョンの z/VSE オペレーティングシステムがインストールされている必要があります。 サポートされるオペレーティングシステムバージョンについては、Natural for Mainframes の最新のリリースノートの「必要なオペレーティング／テレプロセシングシステム」を参照してください。
サポートされるバージョンの Adabas がインストールされている必要があります。 サポートされるバージョンについては、Natural for Mainframes の最新のリリースノートの「Natural および他の Software AG 製品」を参照してください。
一般に、Software AG が提供する Natural オブジェクトを保存するために、主な Software AG 製品ごとに約 20 MB のスペースが Adabas データベースに必要です。
インストールテープには、以下の表に挙げられているデータセットが収録されています。 データセットの収録順と必要なライブラリブロック数については、インストールテープに付属の「テープ作成レポート」を参照してください。
| データセット名 | 内容 |
|---|---|
NATvrs.LICS |
Natural ライセンスキーファイル。 ライセンスキーファイル、ライセンスキーファイルのインストール、製品ライセンスチェック、および製品ライセンスチェックの FAQ については、「Natural のライセンス」を参照してください。
ライセンスキーファイルが電子メールの添付ファイルで提供される場合は、「FTP による PC からホストへのライセンスキーファイルの転送」を参照してください。 |
NATvrs.SYSF |
空の Natural システムファイル |
NATvrs.LIBR |
LIBR バックアップファイル
|
NATvrs.LIBJ |
インストールジョブ |
NATvrs.LDEL |
バージョン 4.1 の Natural システムオブジェクトの削除手順 |
NATvrs.INPL |
Natural システムオブジェクト |
NATvrs.EXPL |
Natural サンプルオブジェクト |
NATvrs.ERRN |
Natural エラーメッセージ |
データセットタイプと、各データセットがディスク上で必要とするスペースについては、「テープ作成レポート」を参照してください。
If you are using SMA, refer to the System Maintenance Aid documentation (included in the current edition of the Natural documentation CD).
If you are not using SMA, follow the instructions below.
This section explains how to:
Copy dataset COPY.JOB from tape to disk.
Modify this dataset to confom with your local naming conventions.
The JCL in this member is then used to copy all datasets from tape to disk.
If the datasets for more than one product are delivered on the tape, the
member COPYTAPE.JOB contains the JCL to unload the datasets for all delivered
products from the tape to your disk, except the datasets that you can directly
install from tape, for example, Natural INPL objects.
After that, you will have to perform the individual install procedure for each component.
The dataset COPYTAPE.JOB (File 5) contains the JCL to unload all other
existing datasets from tape to disk. To unload COPYTAPE.JOB, use the following
sample JCL:
* $$ JOB JNM=LIBRCAT,CLASS=0, + * $$ DISP=D,LDEST=(*,UID),SYSID=1 * $$ LST CLASS=A,DISP=D // JOB LIBRCAT * ***************************************** * CATALOG COPYTAPE.JOB TO LIBRARY * ***************************************** // ASSGN SYS004,nnn <------ tape address // MTC REW,SYS004 // MTC FSF,SYS004,4 ASSGN SYSIPT,SYS004 // TLBL IJSYSIN,'COPYTAPE.JOB' // EXEC LIBR,PARM='MSHP; ACC S=lib.sublib' <------- for catalog /* // MTC REW,SYS004 ASSGN SYSIPT,FEC /* /& * $$ EOJ
where:
nnn is the tape address
lib.sublib is the library and sublibrary
of the catalog
Modify COPYTAPE.JOB to conform to your local naming conventions and set
the disk space parameters before submitting this job.
Submit COPYTAPE.JOB to unload all other datasets from the tape to your
disk.
ライセンスキーファイルが電子メールの添付ファイルで提供された場合は、添付されたライセンスキーファイル natvr.xml を PC からメインフレームに転送する必要があります。ネイティブ FTP コマンドを使用します。
 |
注意: ライセンスキーファイルの転送にネイティブ FTP コマンドではなくユーティリティを使用すると、ライセンスキーが破損し、後で Natural を実行できない場合があります。 これは、本来のバイナリファイル転送ではない、特定の文字を変換する 3270 端末エミュレーションに基づくファイル転送などに該当します。 |
ライセンスキーファイルを PC からメインフレームに転送するには、次の手順に従います。
電子メールの添付ファイルで提供された製品ライセンスキーファイルを PC のハードディスクに保存します。
コマンドプロンプトウィンドウを開きます。 コマンドプロンプトウィンドウで、製品ライセンスキーファイルが保存されているディレクトリに移動します。
z/VSE ホストと通信する FTP セッションを開始します。
ftp host-name
host-name は z/VSE ホストの名前です。
z/VSE ホストのログイン user および password を入力します。
FTP セッションが確立されたら、ライセンスキーファイルの z/VSE サブライブラリを指定します。
ftp>cd lib.sublib
バイナリデータモードに切り替えます（転送中、ライセンスファイルの ASCII フォーマットを維持する必要があるため）。
ftp>bin
ライセンスキーファイルを、指定したサブライブラリにメンバとしてコピーします。
ftp>put natvr.xml NATvrs.LICS
このコマンドにより、指定したサブライブラリにメンバ NATvrs.LICS が作成されます。
以下のコマンドを入力して、FTP セッションを停止します。
ftp>quit
サブライブラリ lib.sublib 内のメンバ NATvrs.LICS を、PROGRAM NATLICAV を使用してアセンブラ入力ファイルに変換します。
アセンブル／リンクして、リンク可能なモジュールを作成します。 このモジュールが Natural ニュークリアスとリンクされます（ジョブ I060）。
（ジョブ I006、手順 0104、およびジョブ I007、手順 0104）
| ジョブ I006、手順 0104 | Natural ライセンスキーをサブライブラリにコピーします。 |
| ジョブ I007、手順 0104 | ライセンスキーモジュールを変換および生成します（NATLIC）。
|
（ジョブ I050、手順 0100）
If you are installing into an existing Natural 4.1 FNAT file, skip this
step.
Load the empty Natural system file (dataset
NATvrs.SYSF) using the ADALOD utility.
This file will contain all Natural objects supplied by Software AG. Its size depends on the number of products to be installed later. As a rule of thumb, 20 MB can be assumed for each major Software AG product.
The following ADALOD parameters must not be altered:
ISNREUSE=YES
To avoid Natural errors NAT9988 and NAT7397 after reorganization of the FNAT
system file using ADAULD/ADALOD, the parameter USERISN
should be set to YES.
FNAT システムファイルのファイル番号 fnat は、Natural の『パラメータリファレンス』ドキュメントの Natural プロファイルパラメータ FNAT の説明に従って選択できます。
（ジョブ I050、手順 0101）
You have the following options:
You can use an existing Version 4.1 FUSER file, then you can skip this
step.
You can use a new FUSER file for Version 4.2.
You can use an existing Version 4.1 FUSER file to be shared by Versions
4.1 and 4.2.
You can use an existing Version 4.1 FUSER file to be used by Version 4.2
only.
For the use of a new and empty FUSER system file for Natural Version 4.2, no
additional system-file-related actions are necessary.
If you do not want to share the FUSER system file, proceed as
follows:
Load the empty Natural user file contained in dataset
NATvrs.SYSF using the ADALOD utility.
In this file, all user-written Natural programs are stored.
The following ADALOD parameters must not be altered:
ISNREUSE=YES
The file number fuser of the FUSER system file
can be chosen as described under Natural profile parameter FUSER in the Natural
Parameter Reference documentation.
If you want to use the existing Natural Version 4.1 FUSER system file and
you do not want to share the FUSER system file, skip this step.
If you use an existing Natural Version 4.1 FUSER system file to be shared by
Natural Versions 4.1 and 4.2, you must upgrade your Natural Version 4.1
installation to Version 4.1.4.
Natural Version 4.1.4 Service Pack I003 or a subsequent Service Pack is required. Service Pack I003 and all subsequent Service Packs contain all the necessary Version 4.1 based solutions for Natural Version 4.2.
The USR* programs from the delivered library SYSEXT run in a special mode.
As a result, the USR* programs do not need to set further steplibs to execute
related objects for processing. This reduces the impact on the Natural buffer
pool search logic and improves the performance significantly if user exits are
used extensively within user written applications.
It is necessary that the user exits are cataloged with Natural Version 4.2. This implies that the user exits cannot be executed with Natural Version 4.1.
Usually, the access of USR* programs by an application requires that the
user application programming interfaces be copied from library SYSEXT to either
the application libraries on the FUSER system file or to library SYSTEM on the
FUSER system file or to library SYSTEM on the FNAT system file, respectively,
or any other library which is defined as steplib for the application. Library
SYSEXT can also be used as steplib. Due to the fact that the delivered user
application programming interfaces will always be cataloged with the latest
Natural version, we recommend that the user application programming interfaces
should reside on the FNAT system file. This will ensure that the right version
is executed and will separate user written applications from Software AG
modules.
If applications which call user application programming interfaces should run with both Natural Version 4.1 and Natural Version 4.2, it must be made sure that the user application programming interfaces delivered with the corresponding Natural version are used.
The following scenarios may be considered:
If the same FUSER system file shall be used in a Natural Version 4.1 and
Version 4.2 environment in parallel the following steps are recommended:
Remove all USR* modules you have copied from library SYSEXT into
application libraries on your FUSER system file.
In both environments, copy the used USR* modules from library SYSEXT to
library SYSTEM on the corresponding FNAT system file.
Alternatively, the USR* modules can be moved to another system library on
FNAT which then must be defined as steplib, or library SYSEXT can be used as
steplib for the applications. Then automatically in both environments the right
versions of the user application programming interfaces are executed.
If you want to use the existing Natural Version 4.1 FUSER system file and
you do not want to share the FUSER system file, then it is still possible to
replace all USR* modules you have copied from library SYSEXT into application
libraries with the new USR* objects from the Version 4.2 library SYSEXT.
But the preferred way is to remove all user application programming
interfaces on the FUSER system file and copy the used user application
programming interfaces from library SYSEXT to library system of the FNAT system
file or use a SYS library on FNAT as steplib.
If you want to port existing applications to a new FUSER system file, copy
all application objects but no Software AG USR* objects to the new FUSER system
file. Then proceed as described in the scenario above.
The FIND function of the Natural utility SYSMAIN can be used to search for
all USR* modules stored in a specific library on the FUSER system file or
across the whole system file. In addition, Predict cross reference data can be
used to determine all referenced user application programming interfaces.
FUSER システムファイルのファイル番号 fuser は、Natural の『パラメータリファレンス』ドキュメントの Natural プロファイルパラメータ FUSER の説明に従って選択できます。
（ジョブ I050、手順 0103）
Skip this step:
if you want to install Predict (in this case, use the corresponding installation step in the Predict Installation documentation), or
if you want to use an existing FDIC system file (an existing FDIC system
file can be shared by Natural Versions 4.1 and 4.2), or
if you do not use your own FDIC system file.
Load the empty FDIC system file contained in dataset
NATvrs.SYSF using the ADALOD utility, as described
below.
The following ADALOD parameters must not be altered:
ISNREUSE=YES
FDIC システムファイルのファイル番号 fdic は、Natural の『パラメータリファレンス』ドキュメントの Natural プロファイルパラメータ FDIC の説明に従って選択できます。
Skip this step,
if you do not use Natural Security, or
if you want to use an existing FSEC system file, or
if you do not want to use an own FSEC system file.
Natural Security を使用する場合は、Natural の『インストール』ドキュメントの「Natural Security のインストール」を参照してください。
（ジョブ I050、手順 0102）
The scratch-pad file (which is a Natural-internal system file) can be used exclusively by the new Natural version or it can be shared by different versions of Natural.
If you do not want to use a scratch-pad file, skip this step.
If you do want to use a scratch-pad file; that is, if you want to use
read-only system files (profile parameter ROSY=ON), see also
Natural Scratch-Pad File in the Natural
Operations documentation, proceed as follows:
Load the empty scratch-pad file contained in dataset
NATvrs.SYSF, using the ADALOD utility as described
below.
The following ADALOD parameter must not be altered:
ISNREUSE=YES
For the optional scratch-pad file inclusion, the following NATPARM parameters must be added or, if already present, updated with:
LFILE=(212,dbid,fnr) ROSY=ON
SMA を使用する場合：読み取り専用システムファイルを使用できるようにするには、SMA パラメータ NAT-SCRF=Y と Natural プロファイルパラメータ ROSY=ON を設定します。
（ジョブ I055、手順 0100）
サブライブラリ lib.sublib に含まれているモジュール NATVSE のソースコードのパラメータを、サイトの要件を満たすように設定します。
NTVSE 生成パラメータの詳細については、Natural の『オペレーション』ドキュメントの「NTVSE マクロ - z/VSE 環境下の Natural の生成パラメータ」を参照してください。
サブライブラリ lib.sublib に含まれている Natural z/VSE インターフェイスモジュール NATVSE をアセンブルおよびリンクします。
（ジョブ I055、手順 0110）
この手順が必要なのは、提供された NATCONFG モジュールを変更する必要がある場合（例えば、NTDVCE マクロ定義を要件に合わせて変更する場合）のみです。
サブライブラリ lib.sublib に含まれているソースを変更およびアセンブルします。
Natural ニュークリアスをリンクする際に（下記参照）、生成された Natural コンフィグレーションモジュール（NATCONFG）を Natural ニュークリアスにリンクします。
NATCONFG のコンフィグレーションテーブルの詳細については、Natural の『オペレーション』ドキュメントの「Natural コンフィグレーションテーブル」を参照してください。
（ジョブ I060、手順 0010）
Natural バッチパラメータモジュールを作成します（ジョブ I060、手順 0010）。
パラメータモジュールの以下のパラメータをインストール用に変更する必要があります。
FNAT=(dbid,fnat) FUSER=(dbid,fuser)
dbid、fnat、および fuser には、前の手順でシステムファイルのロード時に指定した値を使用します（上記参照）。
グローバル Natural バッファプール：グローバル Natural バッファプールを使用する場合は、パラメータマクロ NTBPI にグローバル Natural バッファプールの名前を指定し、すべての Natural パラメータモジュールにプロファイルパラメータ SUBSID を設定します。
SMA を使用する場合：グローバル Natural バッファプールの名前を SMA パラメータ NAT-GLOBAL-BP で定義します。
それ以外のパラメータには、通常はデフォルト値を使用します。
これらのパラメータ値の変更は、デフォルト値が要件を満たさない場合にのみ行ってください。
パラメータモジュールに含まれている各パラメータの詳細については、Natural の『パラメータリファレンス』ドキュメントを参照してください。
パラメータモジュールをアセンブルします。
（ジョブ I060、手順 0020）
以下の方法があります。
バッチフロントエンドをリンク（ジョブ I060、手順 0020）および共有ニュークリアスをリンクするか（ジョブ I060、手順 0105）、または非共有ニュークリアスをリンクします（ジョブ I060、手順 0020）。
Natural z/VSE バッチフロントエンドには RMODE（24） が必要です。これは、この制約がある z/VSE マクロを使用するためです。 非共有ニュークリアスでも RMODE（24）が必要になることから、共有ニュークリアスの使用を強くお勧めします。
SMA を使用する場合：SMA パラメータ SHARED-NUC が Y（yes）に設定されていることを確認します。
1. バッチフロントエンドをリンクします（ジョブ I060、手順 0020）。
以下のモジュールを含める必要があります（モジュール NATVSE を最初に含める）。
| モジュール | 機能 |
|---|---|
NATVSE |
バッチ Natural ドライバ |
NATVSERV |
Natural z/VSE サービス |
PRM020BA |
上記で生成されたパラメータモジュール |
ADAUSER |
Adabas リンクモジュール（オプションで、ADANAME を代わりに使用することも可能）
|
共有ニュークリアスにアクセスするには、ジョブ I060、手順 0105 でリンクした共有モジュールの名前がモジュール NATPARM のパラメータ NUCNAME に含まれていることを確認します。
2. 共有ニュークリアスをリンクします（ジョブ I060、手順 0105）。
含まれるモジュールの一覧については、Natural の『オペレーション』ドキュメントの「z/OS および z/VSE 環境下の Natural 共有ニュークリアス」を参照してください。
または:
非共有ニュークリアスをリンクします（ジョブ I060、手順 0020）。
SMA を使用する場合：パラメータ SHARED-NUC が N（no）に設定されていることを確認します。
SMA を使用しない場合：ジョブ I060、手順 0105（共有ニュークリアス）のすべての INCLUDE ステートメントおよび対応する DD カードを、ジョブ I060、手順 0020（フロントエンド）にマージします。
（ジョブ I060、手順 0120）
Steps 126 EXAMPLE JOB TO START NATURAL GLOBAL BUFFER POOL
127 EXAMPLE JOB TO STOP NATURAL GLOBAL BUFFER POOL
128 EXAMPLE JOB TO START EDITOR GLOBAL BUFFER POOL
129 EXAMPLE JOB TO STOP EDITOR GLOBAL BUFFER POOL
この手順が必要なのは、z/VSE でグローバルバッファプールを使用する場合のみです。 Natural の『オペレーション』ドキュメントの「z/VSE 環境下の Natural グローバルバッファプール」を参照してください。
（この手順は省略可能）
バージョン 4.1 のシステムファイル FNAT を使用している場合は、Natural ユーティリティ INPL を使用して、バージョン 4.1 の Natural システムオブジェクトを置換（削除）します。
SMA を使用している場合：SMA パラメータ NAT-FNAT41 を Y（yes）に設定します。
Natural バージョン 4.1 のみがインストールされている場合
INPL ユーティリティを使用して、データセット NATvrs.LDEL をロードします。
（ジョブ I061、手順 0010）
Review Natural Monitor がインストールされている場合
INPL ユーティリティを使用して、データセット RNMvrs.LDEL をロードします。
（ジョブ I061、手順 0026）
バージョン 4.1 の Natural Security がインストールされている場合
INPL ユーティリティを使用して、データセット NSCvrs.LDEL をロードします。
（ジョブ I061、手順 0099）
（ジョブ I061、手順 0100）
INPL ユーティリティを使用して、Natural システムオブジェクト（データセット NATvrs.INPL）を Natural システムファイルにロードします。
（ジョブ I061、手順 0102）
ユーティリティ SYSERR のプログラム ERRLODUS を使用して、英語の Natural エラーメッセージファイル（データセット NATvrs.ERRN）をロードします（Natural の『ユーティリティ』ドキュメントを参照）。 英語のエラーメッセージの短いテキストと長いテキスト以外に、ドイツ語（ULANG=2）のエラーメッセージの短いテキストがロードされます。
NCJvrs.INPL）をロードします。
（ジョブ I061、手順 8300）
この手順は、英語のエラーメッセージの長いテキストを日本語のエラーメッセージの長いテキストで置き換える場合にのみ必要です。
日本語の Natural エラーメッセージの長いテキストは、Natural 日本語言語パックに収録されています。 これは、別個の製品（製品コード NCJ）で、オプションでロードできます。 日本語の Natural エラーメッセージの長いテキストをロードしない場合は、英語のエラーメッセージの長いテキストが表示されます。
Natural ユーティリティ INPL を使用して、日本語のエラーメッセージの長いテキスト（データセット NCJvrs.INPL）を Natural システムファイルにロードします。
NCJvrs.ERRN）をロードします。
（ジョブ I061、手順 8302）
この手順は、日本語（ULANG=59）のエラーメッセージの短いテキストをロードする場合にのみ必要です。
日本語の Natural エラーメッセージの短いテキストは、Natural 日本語言語パックに収録されています。 これは、別個の製品（製品コード NCJ）で、オプションでロードできます。 日本語の Natural エラーメッセージの短いテキストをロードしない場合は、英語のエラーメッセージの短いテキストが表示されます。
プログラム ERRLODUS（Natural の『ユーティリティ』ドキュメントを参照）を使用して、エラーメッセージの短いテキスト（データセット NCJvrs.ERRN）を Natural システムファイルにロードします。
（ジョブ I061、手順 0103）
INPL ユーティリティを使用して、Natural サンプルオブジェクト（データセット NATvrs.EXPL）を Natural システムファイルにロードします。
基本 Natural については、特別なインストール確認手順はありません。
インストールの最後の手順が正常に完了したら、以下の事項を確認します。
Adabas と Natural の間の通信が機能していること
Natural システムファイルがロードされていること
バッチ Natural が機能していること