このドキュメントでは、BS2000/OSD オペレーティングシステム環境で Adabas システムファイルを使用して Natural をインストールする方法を順を追って説明します。
以下のトピックについて説明します。
Unicode およびコードページサポートのインストール関連情報については、『Unicode およびコードページのサポート』ドキュメントの「Unicode／コードページ環境の設定と管理」を参照してください。
vrs または vr の表記について：このドキュメントでは、vrs または vr は、対応するバージョン、リリース、およびシステムメンテナンスレベル番号を表します。 製品バージョンの詳細については、『用語集』の「バージョン」を参照してください。
サポートされるバージョンの BS2000/OSD オペレーティングシステムがインストールされている必要があります。 サポートされるオペレーティングシステムバージョンについては、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.MOD |
Natural モジュールライブラリ |
NATvrs.SRC |
Natural ソースモジュール |
NATvrs.MAC |
Natural マクロ |
NATvrs.JOBS |
サンプルインストールジョブ |
NATvrs.LDEL |
バージョン 4.1 の Natural システムオブジェクトの削除手順 |
NATvrs.INPL |
Natural システムオブジェクト |
NATvrs.EXPL |
Natural サンプルオブジェクト |
注意:
データセット NATvrs.JOBS は、テープからディスクにコピーされるときに自動的に LMS ライブラリに変換されます。
If you are not using System Maintenance Aid (SMA), use the procedure described below. In this procedure, the values specified below must be supplied.
To copy the datasets from tape to disk, perform the following steps:
This step is not necessary if you have already copied the library
SRVvrs.LIB from another Software AG installation
tape. For further information, refer to the element #READ-ME in this library.
The library SRVvrs.LIB is stored on the tape as a
sequential file named SRVvrs.LIBS containing LMS
commands. The current version vrs can be obtained
from the Report of Tape Creation. To convert this
sequential file into an LMS-library, execute the following commands:
/IMPORT-FILE SUPPORT=*TAPE(FILE-NAME=SRVvrs.LIBS, - / VOLUME=volser, DEV-TYPE=tape-device) /ADD-FILE-LINK LINK-NAME=EDTSAM, FILE-NAME=SRVvrs.LIBS, - / SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT, - / BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT /START-EDT @READ '/' @SYSTEM 'REMOVE-FILE-LINK EDTSAM' @SYSTEM 'EXPORT-FILE FILE-NAME=SRVvrs.LIBS' @WRITE 'SRVvrs.LIBS' @HALT /ASS-SYSDTA SRVvrs.LIBS /MOD-JOB-SW ON=1 /START-PROG $LMS /MOD-JOB-SW OFF=1 /ASS-SYSDTA *PRIMARY
where:
tape-device is the device-type of the
tape, for example: TAPE-C4
volser is the VOLSER of the tape (see
Report of Tape Creation)
To copy the procedure COPY.PROC to disk, call the procedure P.COPYTAPE in
the library SRVvrs.LIB:
/CALL-PROCEDURE (SRVvrs.LIB,P.COPYTAPE), - / (VSNT=volser, DEVT=tape-device)
If you use a TAPE-C4 device, you may omit the parameter DEVT.
To copy all Software AG product files from tape to disk, enter the
procedure COPY.PROC:
/ENTER-PROCEDURE COPY.PROC, DEVT=tape-device
If you use a TAPE-C4 device, you may omit the parameter DEVT. The result
of this procedure is written to the file L.REPORT.SRV.
ライセンスキーファイルが電子メールの添付ファイルで提供された場合は、添付されたライセンスキーファイル natvr.xml を PC からメインフレームに転送する必要があります。ネイティブ FTP コマンドを使用します。
 |
注意: ライセンスキーファイルの転送にネイティブ FTP コマンドではなくユーティリティを使用すると、ライセンスキーが破損し、後で Natural を実行できない場合があります。 これは、本来のバイナリファイル転送ではない、特定の文字を変換する 3270 端末エミュレーションに基づくファイル転送などに該当します。 |
ライセンスキーファイルを PC からメインフレームに転送するには、次の手順に従います。
電子メールの添付ファイルで提供された製品ライセンスキーファイルを PC のハードディスクに保存します。
コマンドプロンプトウィンドウを開きます。 コマンドプロンプトウィンドウで、製品ライセンスキーファイルが保存されているディレクトリに移動します。
BS2000/OSD ホストと通信する FTP セッションを開始します。
ftp host-name
host-name は BS2000/OSD ホストの名前です。
BS2000/OSD ホストのログイン User および Password を入力します。
BS2000/OSD ホストの Account を入力します。
ライセンスキーファイルを FCBTYPE=SAM および RECFORM=V で書き込む必要があることを指定します。
ftp>Literal file NATvrs.LICS,FCBTYPE=SAM,RECFORM=V
バイナリデータモードに切り替えます（転送中、ライセンスファイルの ASCII フォーマットを維持する必要があるため）。
ftp>bin
ライセンスをメインフレームシステムにファイルとして書き込みます。
ftp>put natvr.xml NATvrs.LICS
このコマンドにより、NATvrs.LICS というファイルが作成されます。
ファイルセットは RECFORM=V に設定され、そのファイルセットに含まれるライセンスキー情報は ASCII フォーマットで保存されます。
以下のコマンドを入力して、FTP セッションを停止します。
ftp>quit
以降の説明で、JOBLIB は以下を表します。
SMA を使用していない場合は、サンプルジョブライブラリ（NATvrs.JOBS）
SMA を使用している場合は、SMA ジョブライブラリ（SMA パラメータグループ BASIC の SMA パラメータ JOBLIB の説明を参照）。
注意:
Software AG では、ライブラリ JOBLIB のソース要素に以下の命名規則を使用しています。
A<product-code><function> = アセンブラソース
L<product-code><function> = TSOSLNK/BINDER の命令
例：ANATFRNT、ANATRENT、ANATSTUB、LNATFRNT など
PROGRAM NATLICAB を使用してデータセット NATvrs.LICS をアセンブラ入力ファイルに変換します。
（ジョブ I010、手順 0100）
ライセンスキーファイル（NATvrs.LICS）を変換します。
ライセンスキーモジュールをアセンブルします。 このモジュールが Natural ニュークリアスとリンクされます（ジョブ I060）。
（ジョブ I010、手順 0101）
ANATLIC（Natural BS2000/OSD モジュール 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 プロファイルパラメータ FNAT の説明に従って選択できます。
（ジョブ 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 プロファイルパラメータ FDIC の説明に従って選択できます。
Natural Security を使用する場合は、「Natural Security のインストール」を参照してください。
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.
この手順は、SMA ではサポートされていません。
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
ライセンスキーモジュールをアセンブルおよびリンクします。
（ジョブ I055、手順 0216～218）
以下のソースモジュールをアセンブルします。
ANATSTUB（Natural BS2000/OSD スタブモジュール）
ANATFRNT（Natural BS2000/OSD フロントエンドバッチドライバ）
ANATRENT（Natural BS2000/OSD リエントラントバッチドライバ）
これらのソースモジュールはライブラリ JOBLIB に含まれています。
（ジョブ I060、手順 0010）
Natural バッチパラメータモジュールを作成します。
ライブラリ JOBLIB に含まれているソースパラメータモジュール ANATPARM の以下のパラメータを、インストール用に変更する必要があります。
FNAT=(dbid,fnat) FUSER=(dbid,fuser)
dbid、fnat、および fuser には、システムファイルのロード時に指定した値を使用します（該当するインストール手順を参照）。
それ以外のパラメータには、通常はデフォルト値を使用します。
これらのパラメータ値の変更は、デフォルト値が要件にそぐわない場合にのみ行ってください。
パラメータモジュールに含まれる各パラメータについては、Natural の『パラメータリファレンス』ドキュメントを参照してください。
パラメータモジュールをアセンブルします。
（ジョブ I060、手順 3801、3802）
ソースモジュール LNATFRNT（バッチニュークリアスのフロントエンド部分）と LNATSHAR（バッチニュークリアスの共有部分）をリンクします。
これらのソースモジュールはライブラリ JOBLIB に含まれています。
パラメータモジュールの INCLUDE 命令を使用して、該当する手順で作成された Natural パラメータモジュールの名前を指定します。
ソートプログラム（Natural 内部または外部プログラム）を使用する場合は、モジュール NAT2SORT を含めます。
NAT2SORT をロードライブラリに含めることもできます。これにより、ランタイムにダイナミックにロードできるようになります。このためには、NAT2SORT をプロファイルパラメータ RCA で指定する必要があります。
（ジョブ I061、手順 001）
ライブラリ JOBLIB に含まれているジョブ E.START.ALL を開始します。
すべてのプールを終了するには、ライブラリ JOBLIB に含まれているジョブ E.END.ALL を開始します。
（この手順は省略可能）
バージョン 4.1 のシステムファイル FNAT を使用している場合は、Natural ユーティリティ INPL を使用して、バージョン 4.1 の Natural システムオブジェクトを置換（削除）します。
SMA を使用している場合：SMA パラメータ NAT-OPT-FNAT41 を 'Y'（yes）に設定します。
Natural バージョン 4.1 のみがインストールされている場合：
INPL ユーティリティを使用して、データセット NATvrs.LDEL をロードします。
（ジョブ I061、手順 0010）
バージョン 4.1 の Natural Security がインストールされている場合：
INPL ユーティリティを使用して、データセット NSCvrs.LDEL をロードします。
（ジョブ I061、手順 0099）
（ジョブ I061、手順 0100）
INPL ユーティリティを使用して、Natural システムオブジェクト（データセット NATvrs.INPL）を Natural システムファイルにロードします。
（ジョブ I061、手順 0102）
Natural ユーティリティ SYSERR のプログラム ERRLODUS を使用して、Natural エラーメッセージファイル（データセット NATvrs.ERRN）をロードします（Natural の『ユーティリティ』ドキュメントを参照）。
（ジョブ I061、手順 0103）
INPL ユーティリティを使用して、Natural サンプルオブジェクト（データセット NATvrs.EXPL）を Natural システムファイルにロードします。
（ジョブ I081、手順 1900）
以下のコマンドを発行して、エディタワークファイル（Natural の『オペレーション』ドキュメントの「エディタワークファイル」も参照）を割り当てます。
/FILE dataset-name,LINK=CMEDIT,SPACE=...
次に、フォーマットプログラム（NATEDFM2、NATvrs.MOD）を実行します。「FORMAT」と入力してフォーマットを行い、制御レコードをエディタワークファイルにロードします。
基本 Natural については、特別なインストール確認手順はありません。 インストールの最後の手順が正常に完了したら、以下の事項を確認します。
Adabas と Natural の間の通信が機能していること
Natural システムファイルがロードされていること
バッチ Natural が機能していること
