5.2.1　CALL COMMAND文の形式と規則

(1)　機能

HiRDBのコマンド又はユティリティを実行し，実行結果（標準出力，標準エラー出力，戻り値）を取得できます。

ページの先頭へ

(2)　使用権限

システム共通定義のpd_sql_command_exec_usersオペランドで指定されている認可識別子を持つユーザ

ページの先頭へ

(3)　形式

  CALL COMMAND｛：埋込み変数１｜？パラメタ１｜定数１｝
        〔WITH｛：埋込み変数２｜？パラメタ２｜定数２｝〔，｛：埋込み変数２｜？パラメタ２｜定数２｝〕…〕
        〔INPUT｛：埋込み変数３｜？パラメタ３｜定数３｝〕
        〔OUTPUT TO｛：埋込み変数４　：標識変数１｜？パラメタ４｝〕
        〔ERROR TO｛：埋込み変数５　：標識変数２｜？パラメタ５｝〕
        〔RETURN CODE TO｛：埋込み変数６｜？パラメタ６｝〕
        〔ENVIRONMENT｛：埋込み変数７｜？パラメタ７｜定数４｝〕
        〔SERVER｛：埋込み変数８｜？パラメタ８｜定数５｝〕

ページの先頭へ

(4)　オペランド

ページの先頭へ

(5)　共通規則

1. 実行したコマンドやユティリティによってトランザクションが発生する場合，SQLを実行したトランザクションとは別のものになります。

2. SQLを実行したトランザクションと，実行したコマンドやユティリティによって発生したトランザクションとの間に，排他待ち又はデッドロックが発生する可能性があります。

3. 応答を要求するコマンドやユティリティを実行する場合，そのコマンドやユティリティを正しく終了させることができない標準入力の内容を与えると，システムが無応答になる場合がありますので注意してください。

   （例）

   HiRDBファイルシステム（/hirdb/ios/db0）のバックアップ（pdfbkup）を実行する場合

   コマンドライン上でpdfbkupコマンドを実行すると，バックアップの続行又は終了を確認するため，「G」又は「T」の入力と，改行（CR）の入力が要求されます。

     % pdfbkup /hirdb/ios/db0 /hirdb/ios/db0.backup
     1605756 19:27:29 SQA2          KFPI21514-Q HiRDB file system area
     /hirdb/ios/db0 backup to /hirdb/ios/db0.backup. [G:continue, T:terminate]

   次のようなCALL COMMAND文で，改行を含まない標準入力をpdfbkupコマンドに渡すと，システムは無応答になってしまいます。

     EXEC SQL CALL COMMAND ’pdfbkup’ WITH ’/hirdb/ios/db0;/hirdb/ios/db0.backup’ INPUT ’G’;

   pkfbkupコマンドを正しく実行させるためには，INPUT句には下記のように改行を含めた標準入力を指定してください。

     EXEC SQL BEGIN DECLARE SECTION;
             char input_data[10];
     EXEC SQL END DECLARE SECTION;
     sprintf(input_data, ”G\n”);
     EXEC SQL CALL COMMAND ’pdfbkup’ WITH ’/hirdb/ios/db0;
     /hirdb/ios/db0.backup’ INPUT :input_data;

   システムが無反応になった場合は，HiRDBのプロセス（HiRDB/パラレルサーバの場合はFES，HiRDB/シングルサーバの場合はSDS），及びコマンドやユティリティのプロセスをpdcancelコマンドで終了させてください。

ページの先頭へ

(6)　注意事項

1. コマンドやユティリティのタイムアウトが必要な場合には，クライアント環境定義のPDCALCMDWAITTIMEオペランドを指定してください。コマンド又はユティリティの実行中にタイムアウトした場合，制御用コマンド（pdcmdexec）のプロセス，及び実行中のコマンド又はユティリティのプロセスをpdkillコマンド（UNIX版の場合はOSのkillコマンド）で終了してください。

2. 実行するプラットフォームの制限によって，コマンドやユティリティの実行に失敗する場合があります。次の表に，コマンド又はユティリティを実行できなかった場合に取得する情報と情報の格納先を示します。

   表5‒2　コマンド又はユティリティを実行できなかった場合に取得する情報と情報の格納先

   取得する情報	取得する情報の格納先
   エラーが発生したシステム関数名※ エラーコード※	埋込み変数５又は？パラメタ５
   OSのシステム関数の終了コード	埋込み変数６又は？パラメタ６

   注※

   エラーが発生したシステム関数及びエラーコードは，func=aa....aa,errno=bb....bbの形式で出力されます（errnoは，エラーの状態を表す外部整数変数です）。

   aa....aa：エラーが発生したシステム関数

   bb....bb：エラーコード（エラーコードを取得できない場合，何も格納しません）

   対策

   エラーコードを調査し，errno.h又はユーザが使用するOSのマニュアルを参照して，エラーの原因を取り除き，再度実行してください。

   OSのシステム関数の実行に失敗する原因の一つとして，コマンドやユティリティに指定した引数が，OSで定義されているコマンドライン引数長の限界値を超えたことが考えられます。この問題を解決するためには，OSをチューニングしてコマンドライン引数長の限界値を大きくしてください。

ページの先頭へ

(7)　使用例

1. HiRDBシステムの状態表示（pdfls）を使用して，HiRDBファイルシステム領域（/hirdb/ios/rdfiles）内に存在するHiRDBファイルの一覧を取得します。実行結果はOUTPUT TO句に指定した埋込み変数（output）に代入されます。コマンドライン上から‘pdfls -H /hirdb/ios/rdfiles’を実行する場合と同じ結果が得られます。

     EXEC SQL BEGIN DECLARE SECTION;
             SQL TYPE IS BLOB(1M) OUTPUT;
     EXEC SQL END DECLARE SECTION;
     EXEC SQL CALL COMMAND ’pdfls’ WITH ’-H;/hirdb/ios/rdfiles’ OUTPUT TO :OUTPUT;

2. RDエリアの閉塞コマンド（pdhold）を使用して，RDエリア（RU01，RU02及びRU03）を閉塞します。実行結果はOUTPUT TO句に指定した埋込み変数（output）に代入されます。コマンドライン上から‘pdhold -r RU01,RU02,RU03’を実行する場合と同じ結果が得られます。

     EXEC SQL BEGIN DECLARE SECTION;
             SQL TYPE IS BLOB(1M) OUTPUT;
     EXEC SQL END DECLARE SECTION;
     EXEC SQL CALL COMMAND ’pdhold’ WITH ’-r;RU01,RU02,RU03’ OUTPUT TO :OUTPUT;

   WITH句に複数の定数を指定したい場合は，次のように記述することもできます。

     EXEC SQL BEGIN DECLARE SECTION;
             SQL TYPE IS BLOB(1M) OUTPUT;
     EXEC SQL END DECLARE SECTION;
     EXEC SQL CALL COMMAND ’pdhold’ WITH ’-r;RU01’,’,RU02,RU03’ OUTPUT TO :OUTPUT;

   WITH句に定数及び埋込み変数を指定したい場合は，次のように記述することもできます。

     EXEC SQL BEGIN DECLARE SECTION;
             SQL TYPE IS BLOB(1M) OUTPUT;
             char RDAREAS[100];
     EXEC SQL END DECLARE SECTION;
     sprintf(RDAREAS, ”RU01,RU02,RU03”);
     EXEC SQL CALL COMMAND ’pdhold’ WITH ’-r;’,:RDAREAS OUTPUT TO :OUTPUT;

ページの先頭へ