SYSPARM ユーティリティは、プロファイル名を付けて保存する Natural プロファイルパラメータのセットを作成および管理するために使用します。
ダイナミックプロファイルパラメータを使用して Natural を呼び出す場合は、Natural を呼び出すたびに個々のパラメータを指定できます。 ただし、より簡単な方法として、SYSPARM にパラメータのセットを指定し、そのセットにプロファイル名を付けて保存し、1 つのダイナミックパラメータ PROFILE=profile-name のみを使用して Natural を呼び出すことができます。 このプロファイルに定義したパラメータは、次にダイナミックパラメータとして Natural に渡されるため、PROFILE の構文に準拠している必要があります（『Natural パラメータリファレンス』ドキュメントを参照）。
プロファイルに指定できる個々のプロファイルパラメータの詳細については、『Natural パラメータリファレンス』ドキュメントの「プロファイルパラメータ」を参照してください。
このプロファイルは、Natural システムファイルの FNAT または FUSER に格納されます。 現在の FNAT システムファイルのデータベース ID（DBID）とファイル番号（FNR）は、［SYSPARM Menu］に表示されます。
プロファイルの使用を特定のユーザーに限定するには、プロファイルパラメータ USER を使用します（『Natural パラメータリファレンス』ドキュメントを参照）。
「SYSPARM ユーティリティ」ドキュメントでは、次のトピックについて説明します。
SYSPARM ユーティリティを呼び出すには
Natural システムコマンド SYSPARM を入力します。
［Natural SYSPARM Utility Menu］が表示されます。
［SYSPARM Menu］には、次のフィールドと機能があります。
| フィールド／機能 | 説明 |
|---|---|
| List Profiles |
すべてのプロファイルのリストを表示します。 リストから、表示、変更、または削除するプロファイルを選択できます。 |
| Display Profile |
特定のプロファイルを表示します。 |
| Add New Profile |
新規プロファイルを作成します。 |
| Modify Profile |
既存のプロファイルを変更します。 |
| Copy Profile |
既存のプロファイルをコピーして新規プロファイルを作成します。 |
| Delete Profile |
既存のプロファイルを削除します。 |
| Profile | 指定したプロファイルを選択します。 有効なプロファイル名を入力するか、アスタリスク（*）表記を使用してプロファイルの範囲を選択します。 使用可能なすべてのプロファイルを選択するには、アスタリスク（*）または空白フィールドを使用します。 |
| Copy to | 指定したプロファイルをコピーします。 |
| DBID/FNR | プロファイルを格納する Natural システムファイルのデータベース ID（DBID）とファイル番号（FNR）を選択します。 デフォルトは現在の FNAT です。 |
| Password/Cipher | Adabas ファイルのパスワード（8 文字）とサイファコード（8 桁）を指定します。 |
このドキュメントでは、これ以降上記の SYSPARM 機能について説明します。
この機能では、既存のすべてのプロファイルのリストを表示します。
List Profiles 機能を呼び出すには
［SYSPARM Menu］でファンクションコード「L」を入力し、［Profile］フィールドにプロファイルの名前を入力するか、名前の範囲を指定します。
すべてのプロファイルを表示するには、アスタリスク（*）を入力するか、またはフィールドを空白のままにします。
指定した値で始まる名前を持つすべてのプロファイルを表示するには、例えば ABC* のように、アスタリスク（*）表記を使用します。
指定した値以降の名前を持つすべてのプロファイルを表示するには、例えば ABC> のように、大なり記号（>）を使用します。
指定した値以前の名前を持つすべてのプロファイルを表示するには、例えば ABC< のように、小なり記号（<）を使用します。
［List Profiles］画面が表示されます。
［List Profiles］画面で PF7 キーまたは PF8 キーを押して、リストを上下にスクロールします。
次に、表示、変更、または削除するプロファイルを選択する場合に使用できる PF キーと行コマンドを示します。 プロファイルをカーソルでマークし、適切な PF キーを押すか、プロファイルの横の［Sel.］列に行コマンドを入力し、Enter キーを押します。
| キー |
行 |
機能 |
|---|---|---|
| PF4 | D | 指定したプロファイルの Display Profile 機能を呼び出します。 |
| PF5 | M | 指定したプロファイルの Modify Profile 機能を呼び出します。 |
| PF6 | X | 指定したプロファイルの Delete Profile 機能を呼び出します。 |
この機能は、既存のプロファイルを表示するために使用します。
Display Profile 機能を呼び出すには
［SYSPARM Menu］で、ファンクションコード D とプロファイルの名前を入力します。
または:
［List Profiles］画面で、該当するセクションの説明に従ってプロファイルを選択します。
［Display Profile］画面が開き、指定したプロファイルが表示されます。
プロファイルを変更するには、Modify Profile 機能を呼び出す PF5 キーを押します（「Modify Profile」を参照）。
この機能は、新規プロファイルを作成するために使用します。
Add New Profile 機能を呼び出すには
［SYSPARM Menu］で、ファンクションコード A とプロファイルの名前を入力します。
表示された画面で、「Editing Profiles」の説明に従って、プロファイルに含めるプロファイルパラメータを入力します。
この機能は、既存のプロファイルを変更するために使用します。
Modify Profile 機能を呼び出すには
［SYSPARM Menu］で、ファンクションコード M とプロファイルの名前を入力します。
または:
［Display Profile］画面で、PF5 キーを押します。
または:
［List Profiles］画面で、該当するセクションの説明に従ってプロファイルを選択します。
新規プロファイルを追加する画面に類似した画面が表示され、選択したプロファイルを変更できます（次の「プロファイルの編集」を参照）。
プロファイルの追加または変更用の画面には、それぞれ最大長が 72 文字の 18 行の入力行があります。 入力する個々のパラメータは、1 つ以上の空白またはコンマで区切る必要があります。 パラメータの指定は、任意の数の行にまたがって記述できます。
編集用の追加のスペースが必要な場合、または異なるプロファイルやグループプロファイルをカテゴリごとに組み合わせる場合は、対象のプロファイルの最後のエントリとして PROFILE パラメータを入力して、複数のプロファイルを連結します。 これにより、最初のプロファイルでは、2 番目のプロファイルに指定したパラメータ文字列が最初のプロファイルの文字列の一部として評価されます。
プロファイル P1 の末尾に「PROFILE=P2」を入力し、プロファイル P2 の末尾に「PROFILE=P3」を入力した場合、まず P1 が呼び出され、その後 P2、P3 の順に呼び出されます。
コメントのテキストを各エディタ行に入力したり、コメントを任意の数の行にまたがって記述できます。 コメントの先頭には「/*」を付け、末尾には「*/」を付ける必要があります。
以下に参考情報を示します。
プロファイルの編集用に表示される画面では、次の機能を使用できます。
| キー | 機能 |
|---|---|
| PF4 | プロファイル内のパラメータ指定の構文が正しいかどうかをチェックします。 |
| PF5 | プロファイルを格納します。 |
| PF9 | カーソルのある行の下に空行を 1 行挿入します。 |
| PF10 | カーソルのある行を削除します。 |
| PF11 | カーソルのある行をコピーします。 |
特定のプロファイルパラメータに関するヘルプ情報を呼び出すには
［Help with Parameters］フィールドで、次の操作を行います。
パラメータの名前を入力します。
または、アスタリスク（*）表記を含む文字列を入力します。
その文字列で始まる名前を持つすべてのパラメータが表示されます。
任意の文字でマークを付けて、パラメータを選択します。
またはアスタリスク（*）を入力します。
すべてのパラメータのリストが表示されます。
任意の文字でマークを付けて、パラメータを選択します。
Enter キーを押します。
または:
カーソルを特定のエディタ行に置き、Enter キーを押します（次の「特殊な位置指定」を参照）。
次の 2 つのセクションがある画面が表示されます。
上部のセクションには、指定したパラメータに関するヘルプテキストが表示されます。 テキストが現在の画面を超える場合は、［More Help］フィールドにプラス（+）記号を入力して、次の画面を表示します。 前の画面に戻るにはマイナス（-）記号を入力します。または、Help with Parameters 機能を終了するには、ピリオド（.）を入力します。
下部のセクションは、［Enter your parameter specification］です。
［Enter your parameter specification］では、パラメータ指定を入力します。
PF4 キーを押して、パラメータ指定をチェックします。
PF3 キーを押して、Help with Parameters 機能を終了し、プロファイルの下部、または以前にマークを付けた位置にパラメータ指定を追加します（次の「特殊な位置指定」を参照）。
プロファイルの特定の位置に新規パラメータ指定を追加するには、次の手順に従います。
［Help with Parameters］フィールドに、値（またはアスタリスク）を入力し、Enter キーを押しません。
新規パラメータ指定を配置する行の上のエディタ行にカーソルを置きます。
Enter キーを押して Help with Parameters 機能を呼び出し、パラメータ指定を入力します。
PF3 を押します。
以前にマークを付けたエディタ行の下に、新規パラメータ指定が追加されます。
この機能は、既存のプロファイルをコピーして新規プロファイルを作成するために使用します。
この機能では、同じ Natural システムファイル内でのみプロファイルをコピーできます。 1 つの Natural システムファイルから他の Natural システムファイルにプロファイルをコピーするには、該当するドキュメントの説明に従って SYSMAIN ユーティリティを使用します。
Copy Profile 機能を呼び出すには
［SYSPARM Menu］で次の操作を行います。
ファンクションコード「C」を入力します。
［Profile］フィールドに、既存のプロファイルの名前を入力します。
［Copy To］フィールドに、新規プロファイルの名前を入力します。
この機能は、既存のプロファイルを削除するために使用します。
Delete Profile 機能を呼び出すには
［SYSPARM Menu］で、ファンクションコード「X」を入力します。
または:
［List Profiles］画面で、該当するセクションの説明に従ってプロファイルを選択します。
［Delete a Profile］ウィンドウが表示されます。
［Delete a Profile］ウィンドウで次の操作を行います。
プロファイルの名前を入力して削除を確認し、Enter キーを押します。
または、何も入力しないで Enter キーを押して操作をキャンセルします。
SYSPARM ユーティリティ機能は、ダイレクトコマンドモードまたはバッチモードでも実行できます。
SYSPARM ユーティリティメニューで提供される機能に加えて、コメントのテキスト、入力デリミタ、および INPUT 割り当て文字を指定するためのオプションがバッチモードで提供されます。
このセクションでは、次のトピックについて説明します。
次に、SYSPARM をバッチモードで実行する場合の一般的な使用方法について説明します。
SYSPARM を終了するには、個別の行にピリオド（.）または「FIN」を入力します。「FIN」では Natural セッションが終了します。
1 つ以上の SYSPARM 機能を実行するには、各機能を個別の行に指定します。
機能を 2 行にまたがって記述するには、セッションパラメータ CF（デフォルトは %）で定義した文字を最初の行の任意の場所に入力します。 この文字は、次の行へ続くことを示します。
「バッチでの SYSPARM の例」も参照してください。
「バッチモードでの Natural」（Natural の『オペレーション』ドキュメント）
「非スクリーンモードでの INPUT ステートメントの使用」（Natural の『ステートメント』ドキュメント）
「バッチモードでの INPUT ステートメントの使用」（Natural の『ステートメント』ドキュメント）
SYSPARM ダイレクトコマンドの処理時またはバッチモードで適用される構文を次に示します。 ダイレクトコマンドの使用時に適用される制限の詳細については、次の「キーワードの説明」を参照してください。
図で使用している記号については、『Natural システムコマンドリファレンス』ドキュメントの「システムコマンド構文」セクションを参照してください。
[SYSPARM] |
|
|
|
|
|
profile-name | [where-clause] | [with-clause] |
|
|
|||
DELETE | X |
profile-name | [where-clause] | |||||||||||
COPY |
profile-name1 | TO profile-name2
|
[where-clause] | ||||||||||
|
|
|
|
[character] | ||||||||||
|
|
COMMENT |
|
|
|
[comment] |
|
|
||||||
次のセクションでは、上記の SYSPARM 構文図に示したキーワードと節について簡単に説明し、必要に応じて、特別な使用方法を示します。 コマンドを表すキーワードの詳細については、このセクションで説明した対応する SYSPARM 機能を参照してください。
また、「バッチでの SYSPARM の例」では、キーワードと節の使用方法を示します。
| キーワード | 説明 |
|---|---|
| SYSPARM |
SYSPARM ユーティリティを呼び出します。 |
| ADD | Add Profile 機能を実行します。
コマンド ADD とプロファイルの内容に含まれる後続の入力行を明確に区切るには、キーワード WITH を使用します。 例：
「プロファイルの編集」も参照してください。 |
| MODIFY |
Modify Profile 機能を実行します。 MODIFY コマンドを終了するには、次の例に示すように、個別の行にピリオド（.）を入力します。 プロファイルにコメントのテキストを挿入するには、文字 /* と */ の間にコメントを配置します。 |
| DISPLAY |
Display Profile 機能を実行します。 |
| LIST |
List Profiles 機能を実行します。 |
|
DELETE |
Delete Profile 機能を実行します。 |
| COPY | Copy Profile 機能を実行します。 |
| ASSIGN |
INPUT 割り当て文字を指定または表示します。 現在のセッションに定義された INPUT 割り当て文字を含むデータの処理を開始する前に、INPUT 割り当て文字を変更する必要があります。 さもないと、Natural エラー NAT1105（「入力のためのキーワード ... が定義されていません」）が表示されます。 値が指定されていない場合、出力には現在のセッションに対して定義された文字が含まれます。 |
| DELIMITER |
INPUT 区切り文字を指定または表示します。 現在のセッションに定義された INPUT 区切り文字を含むデータの処理を開始する前に、INPUT 区切り文字を変更する必要があります。 さもないと、Natural エラー NAT1105（「入力のためのキーワード ... が定義されていません」）が表示されます。 値が指定されていない場合、出力には現在のセッションに対して定義された文字が含まれます。 |
| COMMENT |
REPLACE コマンドには適用されません。 コメントオプションをアクティブ（ON）にし、変更された各パラメータの後にコメントを書き込む、またはコメントオプションを非アクティブ（OFF）にします。 アクティブにして個々の comment を指定しない場合（下記参照）、各パラメータに挿入されたコメントに次のデータが含まれます。
コメントを変更するには、REPLACE コマンドを使用します（「キーワードの説明 - WITH 節」を参照）。 |
| character | 任意の特殊文字。Natural の『パラメータリファレンス』ドキュメントに記載されている Natural セッションパラメータ ID（INPUT 区切り文字）および IA（INPUT 割り当て文字）を参照してください。 |
| comment | 文字 /* と */ の間に配置するコメントのテキスト。 |
| profile-name |
プロファイル の名前または名前の範囲。 プロファイルの範囲は、LIST コマンドでのみ指定できます。バッチモードでは、LIST コマンドまたは DISPLAY コマンドでのみ指定できます。 |
|
COPY コマンドにのみ適用されます。 新規プロファイル（profile-name1)）の作成元となるソースプロファイル（profile-name1)）、およびデータのコピー先となるターゲットプロファイル（profile-name2） |
|
| WHERE | where-clause の開始を示すオプションキーワード。 次の「WHERE 節」を参照してください。 |
| WITH |
ADD、DISPLAY、MODIFY、および LIST コマンドにのみ適用されます。 ADD とともに使用する場合、with-clauseは、キーワード WITH とその後に続くプロファイルの内容で構成されます。 with-clause の開始を示すオプションキーワード。 次の「WITH 節」を参照してください。 |
|
|
バッチモードでのみ適用されます。 各機能を個別の行に配置して、1 つ以上の SYSPARM 機能を指定できることを示します。 |
[WHERE] [DBIDdbid] [FNRfnr] [PASSWORDpassword] [CIPHERcipher]
|
ここからは、where-clause で示されるキーワードと適用される値について説明します。
where-clauseは任意指定です。 構文は次のとおりです。
| キーワード | 有効な値 |
|---|---|
| DBID | プロファイルが保存されている Adabas ファイルのデータベース ID（DBID）。 |
| FNR | プロファイルが保存されている Adabas ファイルのファイル番号（FNR）。 |
| PASSWORD | プロファイルが保存されている Adabas ファイルの 8 文字の Adabas パスワード。 |
| CIPHER | プロファイルが保存されている Adabas ファイルの 8 桁のサイファコード。 |
with-clauseは任意指定で、ADD、DISPLAY、MODIFY、および LIST コマンドにのみ適用されます。 構文は次のとおりです。
[WITH]
|
|
|
|
|
text |
|
|||||||||||
|
|
|
|
|||||||||||||||
COMMENT
|
|
|
|
[comment] | |||||||||||||
FIRST |
|
parm-name [parm-value] |
|
||||||||||||||
LINE |
parm-name=parm-value [parm-name=parm-value] ... | ||||||||||||||||
NEW |
parm-name parm-value | ||||||||||||||||
REMOVE |
parm-name | ||||||||||||||||
REPLACE |
|
;text;text; |
|
||||||||||||||
|
|
parm-value |
|
|||||||||||||||
UPDATEparm-name |
|
|
|
number |
|
|
|
|
number |
|
|||||||
parm-name= parm-value[parm-name=parm-value]... |
|||||||||||||||||
注意:
上記の構文図では、次の構文は ADD コマンドにのみ適用されます。[WITH] parm-name=parm-value [parm-name=parm-value]...
ここからは、with-clause で示されるキーワードと適用される値について説明します。
| キーワード | 有効な値 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SCAN |
コマンド LIST および DISPLAY にのみ適用されます。 text 文字列の、現在の Natural システムファイルで使用可能な 1 つ以上のプロファイル（パラメータやパラメータ値など）をスキャンし、指定した text 文字列を含むプロファイルのリストを提供します。 |
||||||||||||||
| NOSCAN |
コマンド LIST および DISPLAY にのみ適用されます。 現在の Natural システムファイルで使用可能な 1 つ以上のプロファイルのスキャンから text 文字列を除外し、指定したテキスト文字列を含まないプロファイルのリストを提供します。 |
||||||||||||||
| ASSIGN | 「キーワードの説明」の「ASSIGN」を参照してください。 | ||||||||||||||
| DELIMITER | 「キーワードの説明」の「DELIMITER」を参照してください。 | ||||||||||||||
| COMMENT | 「キーワードの説明」の「COMMENT」を参照してください。 | ||||||||||||||
| FIRST |
パラメータとその値またはコメントを、プロファイルの最初の位置に移動します。 この操作は、例えば、プロファイルパラメータ PARM を指定する場合に必要なことがあります。 プロファイルの最初の位置に含まれるコメントは、その位置にとどまります。 パラメータとその値は、コメントが最初の位置を占めていない場合にのみ、最初の位置に移動されます。 コメントが最初の位置を占めている場合、パラメータはコメントの後に追加されます。 FIRST で挿入されるコメントは、常に、当初最初の位置を占めていたすべてのコメントの前の位置に配置されます。 |
||||||||||||||
| LINE | LINE の後に指定されたパラメータをプロファイルの最後の新しい行に配置します。 | ||||||||||||||
| NEW | パラメータをプロファイルの最後に付加しますが、必ずしも新しい行に付加するわけではありません。 パラメータを新しい行に配置するには、LINE パラメータを使用します。 | ||||||||||||||
| REMOVE | パラメータおよび割り当てられた値（カッコを含む）をプロファイルから削除します。 削除するパラメータは、プロファイルパラメータ RPC のサブパラメータであるプロファイルパラメータ DFS など、サブパラメータも指定できます。 | ||||||||||||||
| REPLACE |
プロファイルに含まれる古い text 文字列を新しい text 文字列で置き換えます。 「キーワードの説明」のオプション COMMENT も参照してください。 |
||||||||||||||
| UPDATE |
パラメータに割り当てられた値を更新します。 |
||||||||||||||
| parm-name | パラメータの完全な名前。 | ||||||||||||||
| comment | 「キーワードの説明」の「comment」を参照してください。 | ||||||||||||||
| parm-value | パラメータに割り当てられた値。 | ||||||||||||||
| text |
プロファイルに含まれる任意のテキスト文字列。 SCAN および NOSCAN コマンドには次の要件が適用されます。テキスト文字列に空白文字を含めることはできません。 REPLACE コマンドには次の要件が適用されます。 古い text と新しい text のいずれにも空白文字が含まれていない場合、新旧の text の間に空白文字を配置します。 古い text または新しい text に空白文字が含まれている場合、指定した INPUT 区切り文字を古い text と新しい text の間、および新旧の text 文字列全体を囲んで配置します。 例：
指定したデリミタ文字の代わりに、次のいずれかの文字を選択できます。
|
||||||||||||||
| ADD |
指定された数を加算して、パラメータ値のサイズを増やします。 MAX または MIN を指定して、加算を最大値または最小値に制限できます（下記参照）。 |
||||||||||||||
| SUBTRACT |
指定された数を減算して、パラメータ値のサイズを減らします。 MAX または MIN を指定して、減算を最大値または最小値に制限できます（下記参照）。 |
||||||||||||||
| MAX | パラメータ値の最大値を指定します。 | ||||||||||||||
| MIN |
パラメータ値の最小値を指定します。 |
||||||||||||||
| number | 数値。 |
次のサンプルプロファイルと入力例では、SYSPARM コマンドの使用およびバッチで実行されたプロファイル変更の結果を示します。
/* This is a test profile. */ AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(1099,1100,PASSWORD,12345678) RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON,DFS=(SRV2,NODE1,,ACI)) PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD) PRINT=((1,3,6-11,15),AM=NAF) ESIZE=90
/*JCL
.
.
.
*/
SYSPARM
COPY TEST1 TO TESTPROF WHERE DBID 10 FNR 32
DISP TESTPROF
COMMENT ON /* TESTUSER 29.Jul.2003 */
MODIFY TESTPROF with REM DFS
REPLACE ;test profile;test profile for SYSPARM in batch;
NEW BPSIZE 4096
UPDATE ESIZE ADD 20 MAX 100
FIRST PARM INHOUSE
DELIMITER $
UPDATE FUSER (,6)
ASSIGN :
LINE IM=D, INTENS=1, AUTO=T, MT=0, MADIO=0
.
DISP TESTPROF
ADD TESTPRO1 WITH /* 106,210 */
FNAT=(106,210,PASSWORD),FUSER=(,211)
.
DISPLAY TESTPRO1
DELETE TESTPRO2 WHERE DBID 10 FNR 32
X TESTPRO3 WHERE DBID 10 FNR 32
.
FIN
/* This is a test profile for SYSPARM in batch. */ PARM=INHOUSE /* TESTUSER 29.Jul.2003 */ AUTO=ON FNAT = (102,110,PASSWORD) FUSER=(,6) /* TESTUSER 29.Jul.2003 */ RPC=(RPCSIZE=80,SRVNAME=MYSERV,SERVER=ON, ) PRINT=((2,12,18),AM=STD,DEST='PRINT**',OPEN=INITOBJ,CLOSE=CMD) PRINT=((1,3,6-11,15),AM=NAF) ESIZE=100 /* TESTUSER 29.Jul.2003 */ BPSIZE=4096 /* TESTUSER 29.Jul.2003 */ IM=D, INTENS=1, AUTO=T, MT=0, MADIO=0 /* TESTUSER 29.Jul.2003 */
/* 106,210 */ FNAT=(106,210,PASSWORD),FUSER=(,211)