バージョン 4.2.5	検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ

SYSEXT ユーティリティを使用すると、現在のシステムライブラリ SYSEXT に含まれている Natural アプリケーションプログラミングインターフェイス（API）を検索し、テストできます。

Natural API は Natural サブプログラム（カタログ化オブジェクト）で、データにアクセスして必要に応じて変更したり、Natural に固有のサービス、サブコンポーネント、またはサブ製品を実行したりする場合に使用します。 Natural API の目的は、情報を取得または変更したり、Natural ステートメントではアクセスできないサービスを使用したりすることです。

「SYSEXT ユーティリティ- Natural アプリケーションプログラミングインターフェイス」ドキュメントでは、次のトピックについて説明します。

• SYSEXT の基本機能

• SYSEXT の呼び出しと終了

• SYSEXT ユーティリティ画面

• SYSEXT ユーティリティ機能の実行

• Natural API の使用

• Natural API のリスト

関連トピック：

• 「Natural ユーザー出口」 - 『オペレーション』ドキュメント

• 「Application Programming Interfaces」 - 『Natural Security』ドキュメント

• 「Application Programming Interfaces」 - 『Natural SAF Security』ドキュメント

• 「SYSAPI - Natural アドオン製品の API」 - 『ユーティリティ』ドキュメント

SYSEXT の基本機能

SYSEXT ユーティリティには、各 Natural API について、機能説明、1 つのプログラム例、および API に固有のキーワードがあります。

次の図に、SYSEXT で提供されている、API をテストし、実装するための Natural オブジェクトおよび主な機能の概要を示します。

Natural API に提供されているオブジェクト

各 Natural API に提供されている一般的な Natural オブジェクトのタイプは、次のセクションでリストされています。 特定の API で必要となる追加オブジェクトは、リストされていません。

API のすべての関連オブジェクトは、システムファイル FNAT のライブラリ SYSEXT に含まれています。

次のテーブルで、nnnn は、API に割り当てられている 4 桁の数字です。 相互に関連しているすべての API オブジェクトには、識別番号が付いています。

SYSEXT の呼び出しと終了

このセクションでは、SYSEXT ユーティリティの呼び出しおよび終了手順について説明します。

SYSEXT を呼び出すには

• 次のシステムコマンドを入力します。

  SYSEXT

  次の例のような SYSEXT ユーティリティ画面が表示され、使用可能な Natural API がすべてリストされます。

  13:11:42 ***** NATURAL SYSEXT UTILITY ***** 2005-08-01 User SAG - Menu - Library SYSEXT Cmd Source Interface Comment Prod _ USR0010P USR0010N Get 'SYSPROF' Information NAT _ USR0011P USR0011N Information about logical file NAT _ USR0020P USR0020N Read any error text from FNAT / FUSER NAT _ USR0040P USR0040N Get type of last error NAT _ USR0050P USR0050N Get 'SYSPROD' Information NAT _ USR0060P USR0060N Copy LFILE definition from 'FNAT' to 'FUSER' NAT _ USR0070P USR0070N Default Editor Profile 'SYSTEM' NAT _ USR0080P USR0080N Handle Type/Name of Editor Contents NAT _ USR0100P USR0100N Control LRECL NVS _ USR0120P USR0120N Read Natural Short Error Message NAT _ USR0210P USR0210N Save, cat or stow NATURAL object NAT _ USR0220P USR0220N Read Natural Long Error Message NAT _ USR0320P USR0320N Read User Short Error Message from FNAT or FUSER NAT _ USR0330P USR0330N Read Natural Object Directory NAT Keyword .. ________________ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit -- + Canc

  このリストは、プログラム例の名前（USRnnnnP）によってソートされます。 必要に応じて、PF8 キーを押してリストを下方にスクロールしたり、PF7 キーを押してリストの先頭に戻ったりできます。

SYSEXT を終了するには

• SYSEXT ユーティリティ画面で PF3 キーまたは PF12 キーを押します。

  または:
  コマンド行にピリオド（.）または EXIT を入力します。

SYSEXT ユーティリティ画面

次の表に、SYSEXT ユーティリティ画面に表示されるフィールドおよび列とその説明を示します。

SYSEXT ユーティリティ機能の実行

SYSEXT ユーティリティの機能を使用すると、テキストオブジェクトに対する操作、および SYSEXT ユーティリティ画面の API リストで参照されるプログラム例を実行できます。 また、キーワード検索機能を使用して、API のリストを短くしたり、API に対して使用可能なすべてのキーワードをリストしたりすることもできます。

以下のセクションでは、次のトピックについて説明します。

• 行コマンド

• キーワード検索

行コマンド

行コマンドを使用すると、オブジェクト操作を実行できます。 行コマンドは、目的の API の横の［Cmd］列に入力します。 この列に疑問符（?）を入力すると、有効な行コマンドがリストされます。

SYSEXT ユーティリティ画面では、次の行コマンドを使用できます。

キーワード検索

キーワードは、現在のタスクに関連した Natural API の検索に役立ちます。 キーワード検索機能を使用すると、キーワードで API をリストしたり、特定の API に関連したキーワードをリストしたりできます。

キーワードで API をリストするには

• 次のいずれかの方法を選択します。

  • キーワードを 1 つ入力します。

    SYSEXT ユーティリティ画面の［Keyword］フィールドにキーワードを入力し、Enter キーを押します。

    指定したキーワードを適用するすべての API が表示されます。

  • 有効なキーワードのリストからキーワードを 1 つ選択します。

    1. SYSEXT ユーティリティ画面の［Keyword］フィールドにアスタリスク（*）を入力し、Enter キーを押します。

       次の例に示すように、［List Keywords］ウィンドウに、すべての API に使用可能なキーワードがすべてリストされます。

       必要に応じて、PF8 キーを押してキーワードのリストを下方にスクロールしたり、PF7 キーを押してリストの先頭に戻ったりできます。

    2. 目的のキーワードの横にある［M］列に任意の文字を入力して、Enter キーを押します。

       または［Direct］フィールドに目的のキーワードを入力して、Enter キーを押します。

       指定したキーワードを適用するすべての API が表示されます。

  • 有効なキーワードのリストから複数のキーワードを選択します。

    1. SYSEXT ユーティリティ画面の［Keyword］フィールドにアスタリスク（*）を入力し、Enter キーを押します。

       次の例に示すように、［List Keywords］ウィンドウに、すべての API に使用可能なキーワードがすべてリストされます。

       必要に応じて、PF8 キーを押してキーワードのリストを下方にスクロールしたり、PF7 キーを押してリストの先頭に戻ったりできます。

    2. 目的のキーワードの横にある［M］列にアスタリスク（*）を入力して、Enter キーを押します。

       次の例のような［Keyword］ウィンドウが表示され、選択した最初のキーワード（この例では *LANGUAGE）が適用されるすべての API がリストされます。

       11:08:58 ***** NATURAL SYSEXT UTILITY ***** 2005-11-10 User SAG - Menu - Library SYSEXT Cm +--------List Keywords---------+ +--------Keyword *LANGUAGE--------+ Prod _ ! ! ! ! NAT _ ! M Keyword ! ! Object ! NAT _ ! _ *DATX ! ! USR0020P ! NAT _ ! _ *ERROR-NR ! ! USR0120P ! NAT _ ! _ *ERROR-TA ! ! USR0320P ! NAT _ ! * *LANGUAGE ! ! USR1027P ! NAT _ ! _ *LEVEL ! ! USR1030P ! NAT _ ! _ *STEPLIB ! ! USR2034P ! NAT _ ! * *TIMESTMP ! ! USR3320P ! NVS _ ! _ *TIMX ! ! ! NAT _ ! _ ABEND ! ! ! NAT _ ! ! ! ! NAT _ ! Direct ... ________________ ! ! ! R NAT _ ! ! ! ! NAT +------------------------------+ +---------------------------------+ Keyword .. *_______________ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit -- + Canc

    3. Enter キーを押して、選択した次のキーワード（この例では *TIMESTMP）の［Keyword］ウィンドウを開きます。

    4. Enter キーまたは PF3 キーを押して、［List Keywords］ウィンドウに戻ります。

    5. PF3 キーを押してすべてのウィンドウを終了し、SYSEXT ユーティリティ画面に戻ります。

特定のAPI に関連するキーワードをリストするには

• 目的の API の横に行コマンド K を入力します。 次の例に示すように、指定した API の［Keywords］ウィンドウが表示され、この API に関連するキーワードがすべてリストされます。

  11:24:27 ***** NATURAL SYSEXT UTILITY ***** 2005-11-10 User SAG - Menu - Library SYSEXT Cmd Source Interface Comment Prod K USR0010P USR0010 +--Keywords for USR0010P--+ NAT _ USR0011P USR0011 ! ! file NAT _ USR0020P USR0020 ! DBID ! FNAT / FUSER NAT _ USR0040P USR0040 ! ENVIRONMENT ! NAT _ USR0050P USR0050 ! FILE ! NAT _ USR0060P USR0060 ! FNAT ! m 'FNAT' to 'FUSER' NAT _ USR0070P USR0070 ! FNR ! YSTEM' NAT _ USR0080P USR0080 ! FUSER ! r Contents NAT _ USR0100P USR0100 ! SYSPROF ! NVS _ USR0120P USR0120 ! ! Message NAT _ USR0210P USR0210 ! ! object NAT _ USR0220P USR0220 ! ! essage NAT _ USR0320P USR0320 +-------------------------+ sage from FNAT or FUSER NAT _ USR0330P USR0330N Read Natural Object Directory NAT Keyword .. ________________ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---;

  必要に応じて、PF8 キーを押してリストを 1 ページ下方にスクロールします。 リストの先頭に移動するには、PF7 キーを押します。

Natural API の使用

ライブラリ SYSEXT に含まれている API を 1 つ使用する場合、次の選択肢があります。

1. ライブラリ SYSEXT をアプリケーションの steplib として定義します（推奨）。

2. 選択したサブプログラムをシステムファイル FNAT のライブラリ SYSTEM にコピーします（推奨）。

3. 選択したサブプログラムをアプリケーションの任意の steplib にコピーします。

4. 選択したサブプログラムをアプリケーションライブラリにコピーします。

選択肢 1 には、Natural インストールのアップグレード時に API に固有のアクティビティの必要がないという利点があります。

選択肢 2 には（選択肢 3 および 4 と比べて）、すべての API が 1 つのライブラリにあるという利点があります。 Natural インストールをアップグレードする場合は、アップグレードする必要がある API のライブラリを 1 つ確認するだけで済みます。

Natural API のリスト

次の SYSEXT ユーティリティで使用できる Natural アプリケーションプログラミングインターフェイス（API）のリストには、全般的な情報のみが示されています。 API の現在のステータスについては、システムコマンド SYSEXT を実行します。

リストの列は、SYSEXT ユーティリティ画面に表示される列と対応しています。 列の詳細については、「SYSEXT ユーティリティ画面」を参照してください。

Natural リモートプロシージャコール（RPC）に適用される API の使用の詳細については、『Natural リモートプロシージャコール』ドキュメントの「Natural RPC で使用するアプリケーションプログラミングインターフェイス」を参照してください。

www.softwareag.com

Copyright © Software AG 1979-2009. All rights reserved.

検索   索引   目次   |   PDF ブック   |   ホーム   上へ   戻る   次へ