このドキュメントでは、z/OS オペレーティングシステム環境で Adabas システムファイルを使用して Natural をインストールする方法を順を追って説明します。
以下のトピックについて説明します。
Natural の『オペレーション』ドキュメントの「z/OS 環境」も参照してください。
Unicode およびコードページサポートのインストール関連情報については、『Unicode およびコードページのサポート』ドキュメントの「Unicode／コードページ環境の設定と管理」を参照してください。
vrs または vr の表記について：このドキュメントでは、vrs または vr は、対応するバージョン、リリース、およびシステムメンテナンスレベル番号を表します。 製品バージョンの詳細については、『用語集』の「バージョン」を参照してください。
サポートされるバージョンの z/OS オペレーティングシステムがインストールされている必要があります。 サポートされるオペレーティングシステムバージョンについては、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.ERRN |
Natural エラーメッセージ |
NATvrs.LOAD |
Natural ロードモジュール |
NATvrs.OBJS |
Natural オブジェクトモジュール |
NATvrs.SRCE |
Natural ソースモジュールおよびマクロ |
NATvrs.JOBS |
サンプルインストールジョブ |
NATvrs.LDEL |
バージョン 4.1 の Natural システムオブジェクトの削除手順 |
NATvrs.INPL |
Natural システムオブジェクト |
NATvrs.EXPL |
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 conform to your local naming conventions.
The JCL in this dataset 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
dataset COPY.JOB contains the JCL to unload the datasets for all delivered
products from the tape to your disk.
After that, you will have to perform the individual install procedure for each component.
The dataset COPY.JOB (Label 2) contains the JCL to unload all other
existing datasets from tape to disk. To unload COPY.JOB, use the following
sample JCL:
//SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X //* --------------------------------- //COPY EXEC PGM=IEBGENER //SYSUT1 DD DSN=COPY.JOB, // DISP=(OLD,PASS), // UNIT=(CASS,,DEFER), // VOL=(,RETAIN,SER=tape-volume), // LABEL=(2,SL) //SYSUT2 DD DSN=hilev.COPY.JOB, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,VOL=SER=volume, // SPACE=(TRK,(1,1),RLSE), // DCB=*.SYSUT1 //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY //
where:
hilev is a valid high level
qualifier
tape-volume is the tape volume name, for
example: T12345
volume is the disk volume name
Modify the COPY.JOB on your disk to conform to your local naming conventions and set
the disk space parameters before submitting this job:
Set HILEV to a valid high level qualifier.
Set LOCATION to a storage location.
Set EXPDT to a valid expiration date.
Submit COPY.JOB to unload all other datasets from the tape to your
disk.
ライセンスキーファイルが電子メールの添付ファイルで提供された場合は、添付されたライセンスキーファイル natvr.xml を PC からメインフレームに転送する必要があります。ネイティブ FTP コマンドを使用します。
 |
注意: ライセンスキーファイルの転送にネイティブ FTP コマンドではなくユーティリティを使用すると、ライセンスキーが破損し、後で Natural を実行できない場合があります。 これは、本来のバイナリファイル転送ではない、特定の文字を変換する 3270 端末エミュレーションに基づくファイル転送などに該当します。 |
ライセンスキーファイルを PC からメインフレームに転送するには、次の手順に従います。
電子メールの添付ファイルで提供された製品ライセンスキーファイルを PC のハードディスクに保存します。
コマンドプロンプトウィンドウを開きます。 コマンドプロンプトウィンドウで、製品ライセンスキーファイルが保存されているディレクトリに移動します。
z/OS ホストと通信する FTP セッションを開始します。
ftp host-name
host-name は z/OS ホストの名前です。
z/OS ホストのログイン ID とパスワードを入力します。
FTP セッションが確立されたら、ライセンスキーファイルの z/OS ファイルシステムとデータセットの接頭辞を指定します。
ftp>cd 'hilev'
バイナリデータモードに切り替えます（転送中、ライセンスファイルの ASCII フォーマットを維持する必要があるため）。
ftp>binary
ライセンスキーファイルのデータセットが RECFM=FB および LRECL=80 で書き込まれるように指定します。
ftp>quote site RECFM=FB LRECL=80 BLKSIZE=4000
注意:
製品ライセンスキーファイルでは RECFM=F もサポートされています。
ライセンスキーファイルをデータセットとして z/OS システムにコピーします。
ftp>put natvr.xml NATvrs.LICS
このコマンドにより、hilev.NATvrs.LICS というデータセットが作成されます。
接頭辞として NATURAL を指定した場合は、データセット名は NATURAL.NATvrs.LICS になります。
データセットは RECFM=FB、LRECL=80 になり、ライセンスキー情報は ASCII フォーマットでそのデータセットに保存されます。
以下のコマンドを入力して、FTP セッションを停止します。
ftp>quit
PROGRAM NATLICAM を使用して、データセット hilev.NATvrs.LICS をアセンブラ入力ファイルに変換します。
アセンブル／リンクして、リンク可能なモジュールを作成します。 このモジュールが Natural ニュークリアスとリンクされます（ジョブ I060）。
（ジョブ I007、手順 0102 および 0104）
| ジョブ I007、手順 0102 | ライセンスキーファイル（NATvrs.LICS）を変換します。
|
| ジョブ I007、手順 0104 | ライセンスキーモジュールをアセンブルおよびリンクします（NATLIC）。
|
（ジョブ I009、手順 1200、1210、1220、1250）
以下の Natural モジュールを Authorized Program Facility（APF）ライブラリにリンクします。
NATGBP42 |
グローバルバッファプールをインストールする場合に必要です。 |
NATASM42 |
認可サービスマネージャ（ASM）をインストールする場合に必要です。
以下の場合は、ASM を使用する必要があります。
|
NATRSM42 |
Natural ロールサーバーをインストールする場合に必要です。
以下の場合は、RSM を使用する必要があります。
詳細については、『オペレーション』ドキュメントの「Natural ロールサーバーの操作」も参照してください。 |
| RPC サーバーフロントエンド |
Natural リモートプロシージャコール（RPC）による偽装を使用する場合に必要です。 SMA を使用する場合：RPC サーバーフロントエンドの名前をパラメータ SMA を使用しない場合：RPC サーバーフロントエンドの名前は自由に選択でき、ジョブ I009、手順 1250 のリンクエディット手順で指定します。 RPC サーバーフロントエンドを APF 認可 |
（ジョブ I015、手順 0100、0101、0102、0104）
| 手順 | 作成するジョブ | 機能 |
| 0100 | GBNASTRT |
Natural グローバルバッファプールを起動します。 |
| 0101 | GBNASTOP |
Natural グローバルバッファプールを停止します。 |
| 0102 | GBEDSTRT |
Editor グローバルバッファプールを起動します。 |
| 0104 | GBEDSTOP |
Editor グローバルバッファプールを停止します。 |
これらの手順が必要なのは、グローバルバッファプールを使用する場合のみです。
Natural を使用する前に、ジョブ GBNASTRT および GBEDSTRT を作成して開始します。
グローバルバッファプールの詳細については、Natural の『オペレーション』ドキュメントの「Natural グローバルバッファプール」を参照してください。
z/OS パラメータ ALLOWUSERKEYCSA(NO) がデフォルトで適用されるか、SYS1.PARMLIB(DIAGxx) で明示的に指定されている場合は、認可サービスマネージャのインストールが必須です。
（ジョブ 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 の説明に従って選択できます。
（ジョブ I0050、手順 990）
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 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 を使用する場合：読み取り専用システムファイルを使用できるようにするには、パラメータ NAT-SCRF を Y に、ROSY を ON に設定する必要があります。
（ジョブ I055、手順 0100 または 0103）
ソースプログラム NATOS には、Natural z/OS インターフェイスを生成するマクロ NTOS の呼び出しが含まれています。
ジョブ I055、手順 0100、IEBUPDATE を実行します。
ジョブ I055、手順 0103、NATOS をアセンブルおよびリンクします。
モジュール NATOS のソースのパラメータを、要件を満たすように設定します。
マクロ NTOS に含まれている Natural for z/OS 生成パラメータの詳細については、Natural の『オペレーション』ドキュメントの「Natural z/OS 生成パラメータ」を参照してください。
データセット hilev.NATvrs.SRCE に含まれている Natural z/OS インターフェイスモジュール NATOS をアセンブルおよびリンクします。
（ジョブ I055、手順 0110）
この手順が必要なのは、提供された NATCONFG モジュールを変更する必要がある場合（例えば、NTDVCE マクロ定義を要件に合わせて変更する場合）のみです。
データセット hilev.NATvrs.SRCE に含まれているソースを変更およびアセンブルします。
Natural ニュークリアスをリンクする際に（下記参照）、生成された Natural コンフィグレーションモジュール（NATCONFG）を Natural ニュークリアスにリンクします。
NATCONFG のコンフィグレーションテーブルの詳細については、Natural の『オペレーション』ドキュメントの「Natural コンフィグレーションテーブル」を参照してください。
（ジョブ I060、手順 0010、0015）
バッチ Natural パラメータモジュールを作成します。
パラメータモジュールの以下のパラメータをインストール用に変更する必要があります。
FNAT=(dbid,fnat) FUSER=(dbid,fuser)
dbid、fnat、および fuser には、システムファイルのロード時に指定した値を使用します（上記参照）。
グローバル Natural バッファプール：グローバル Natural バッファプールを使用する場合は、パラメータマクロ NTBPI にグローバル Natural バッファプールの名前を指定し、すべての Natural パラメータモジュールにプロファイルパラメータ SUBSID を設定します。
SMA を使用する場合：グローバル Natural バッファプールの名前を SMA パラメータ NAT-GLOBAL-BP で定義します。
それ以外のパラメータ：通常はデフォルト値を使用できます。 これらのパラメータ値の変更は、デフォルト値が要件を満たさない場合にのみ行ってください。
パラメータモジュールに含まれている各パラメータの詳細については、Natural の『パラメータリファレンス』ドキュメントの「パラメータリファレンス」で概要を参照してください。
パラメータモジュールをアセンブルおよびリンクします。
Natural ニュークリアスは、以下の方法でリンクできます。
バッチフロントエンドをリンク（ジョブ I060、手順 0020）および共有ニュークリアスをリンクするか（ジョブ I060、手順 0105）、または非共有ニュークリアスをリンクします（ジョブ I060、手順 0020）。
バッチフロントエンドのリンク（ジョブ I060、手順 0020）
SMALOAD が APF 認可であり、z/OS バインダを使用する場合は、バッチニュークリアスを NORENT としてリンクします。
パラメータモジュールの INCLUDE 命令で、前に作成した Natural パラメータモジュールの名前を指定します。
以下のモジュールを含める必要があります（モジュール NATOS を最初に含める）。
| モジュール | 機能 |
|---|---|
NATOS |
バッチ Natural ドライバ |
NATWKFO |
ワークファイルのサポート |
PR001B |
生成されたパラメータモジュール |
ADAUSER |
Adabas リンクモジュール |
共有ニュークリアスにアクセスするには、ジョブ I060、手順 0105 でリンクしたモジュールの名前が NATPARM パラメータ NUCNAME に含まれていることを確認します。
バッチフロントエンドをリンクします。
共有ニュークリアスのリンク（ジョブ I060、手順 0105）
含まれるモジュールの一覧については、Natural の『オペレーション』ドキュメントの「z/OS および z/VSE 環境下の Natural 共有ニュークリアス」を参照してください。
共有ニュークリアスをリンクします。
または:
非共有ニュークリアスのリンク（ジョブ I060、手順 0020）
SMA を使用する場合：
SMA パラメータ SHARED-NUC が N（no）に設定されていることを確認します。 これにより、すべてのモジュールが手順 0020 で自動的にリンクされます。
SMA を使用しない場合：
ジョブ I060、手順 0105（共有ニュークリアス）のすべての INCLUDE ステートメントおよび対応する DD カードを、ジョブ I060、手順 0020（フロントエンド）にマージします。
実行可能な Natural ニュークリアスをリンクします。
（この手順は省略可能）
バージョン 4.1 のシステムファイル FNAT を使用している場合は、Natural ユーティリティ INPL を使用して、バージョン 4.1 の Natural システムオブジェクトを置換（削除）します。
SMA を使用している場合：SMA パラメータ NAT-FNAT41 を Y（yes）に設定します。
Natural バージョン 4.1 のみがインストールされている場合
データセット NATvrs.LDEL に対して INPL を実行します。
（ジョブ I061、手順 0010）
Natural for DB/2 がインストールされている場合
データセット NDBvrs.LDEL に対して INPL を実行します。
（ジョブ I061、手順 0016）
Review Natural Monitor がインストールされている場合
データセット RNMvrs.LDEL に対して INPL を実行します。
（ジョブ I061、手順 0026）
バージョン 4.1 の Natural Security がインストールされている場合
データセット NSCvrs.LDEL に対して INPL を実行します。
（ジョブ I061、手順 0099）
（ジョブ I061、手順 0100）
Natural ユーティリティ INPL を使用して、Natural システムオブジェクト（データセット NATvrs.INPL）を Natural システムファイルにロードします。
（ジョブ I061、手順 0102）
プログラム 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）
Natural ユーティリティ INPL を使用して、Natural サンプルオブジェクト（データセット NATvrs.EXPL）を Natural システムファイルにロードします。
（ジョブ I200、手順 0101）
この手順が必要なのは、Natural ロールサーバーを使用する場合のみです。
注意:
以前のバージョンの既存のロールファイルを使用する予定の場合は、NATRSRFI RESET 機能を実行するだけで十分です。 詳細については、Natural の『オペレーション』ドキュメントの「Natural ロールサーバーの操作」を参照してください。
Natural を使用する前に、ジョブ FORMRF1 を作成して開始します。
各種ロールファイルの詳細については、Natural の『TP モニタインターフェイス』ドキュメントの「CICS 環境での Natural」および「IMS/TM 環境での Natural」を参照してください。
（ジョブ I200、手順 0102）
この手順が必要なのは、Natural ロールサーバーを使用する場合のみです。
Natural を使用する前に、ジョブ ROLLSV1 を作成して開始します。
Natural ロールサーバーの詳細については、Natural の『オペレーション』ドキュメントの「Natural ロールサーバーの操作」を参照してください。
（ジョブ I200、手順 0103）
この手順が必要なのは、Natural 認可サービスマネージャを使用する場合のみです。
Natural を使用する前に、ジョブ AUTHSV1 を作成して開始します。
詳細については、Natural の『オペレーション』ドキュメントの「z/OS での認可サービスマネージャ」を参照してください。
（ジョブ I200、手順 0108、0109、0115、0120）
サンプル Natural RPC サーバー。
手順 0115、標準 Natural RPC サーバーを実行する JCL を作成します。
手順 0120、RPC サーバーフロントエンドで Natural RPC サーバーを実行する JCL を作成します。 この JCL は偽装に必要です。
Natural RPC を使用する場合：SMA グループ RPC のパラメータを適宜設定します。特に、パラメータ NAT-RPC を Y（yes）に設定します。
基本 Natural については、特別なインストール確認手順はありません。
インストールの最後の手順が正常に完了したら、以下の事項を確認します。
Adabas と Natural の間の通信が機能していること
Natural システムファイルがロードされていること
バッチ Natural が機能していること