バージョン 4.2.5
 —  ステートメント  —

DOWNLOAD PC FILE

DOWNLOAD

PC

[FILE] work-file-number

[VARIABLE] operand1

WRITE WORK COMMAND operand2

SYNC

ASYNC

このドキュメントでは、次のトピックについて説明します。

構文図で使用されている記号については、「構文記号」を参照してください。

関連ステートメント:CLOSE PC FILE | UPLOAD PC FILE | WRITE WORK FILE

関連機能グループ:「ワークファイル/PC ファイルの制御


機能

このステートメントは、データを メインフレーム プラットフォームから PC に転送するために使用します。

詳細については、『Natural Connection』ドキュメントと『Entire Connection』ドキュメントを参照してください。

Top of page

構文説明

オペランド定義テーブル:

オペランド 構文要素 フォーマット オペランド参照 ダイナミック定義
operand1 C S A G   A U N P I F B D T L C 不可
operand2 C S       A                    

フォーマット C と G は、いずれも Natural Connection では無効です。

構文要素の説明:

work-file-number 使用するワークファイル番号を指定します。 この番号は、Natural に対する定義に従って、PC のワークファイル番号の 1 つに対応している必要があります。
VARIABLE PC ファイルに書き込まれるレコードは可変フォーマットです。 可変レコードは PC のスプレッドシート形式に変換できません。
operand1
フィールド指定:

operand1 では、PC にダウンロードするフィールドを指定します。

COMMAND

COMMAND 節を使用すると、メインフレームから PC に PC コマンド(つまり、PC 上の Entire Connection のコマンド行に入力できる任意のコマンド)を送信できます。

Entire Connection 側で、送信されたコマンドが有効かどうかがチェックされます。 PC で認識できないコマンドは拒否されます。 この場合は、ダウンロードされたコマンドが PC で拒否されたことを示すエラーメッセージが発行されます。

COMMAND 節を使用すると、例えば、メインフレームから Entire Connection のタスクを実行できます。 PC のディレクトリ情報を一覧表示するタスク DIR を実行する場合は、メインフレーム上の Natural プログラムで次のステートメントを使用してすぐに実行できます。

DOWNLOAD PC FILE 7 COMMAND 'DIR'

下記の「例 2」では、COMMAND 節を使用して、ダウンロードされたデータを受け取る PC ファイルの名前を定義します。 この方法では、ファイル名を入力する手間を省くことができます。

operand2
COMMAND の指定:

operand2 では、PC 上で実行する DOS コマンドまたは Entire Connection タスクを指定します。 operand2 は、英数字の定数または変数にする必要があります。

SYNC SYNC では、COMMAND の実行と終了後に PCから Natural に制御を返すことを指定します。 SYNC を使用すると、例えば、ファイル転送を開始する前にコマンド SET PCFILE を確実に実行することができます。
ASYNC ASYNC では、COMMAND の実行が終了したかどうかに関係なく、PC から Natural に制御を直ちに返すことを指定します。

Top of page

例 1 - DOWNLOAD PC FILE ステートメントの使用例

次のプログラムで、DOWNLOAD PC FILE ステートメントの使用方法を示します。 最初にデータが選択され、続いて Work File 7 を使用して PC にダウンロードされます。

** Example 'PCDOEX1': DOWNLOAD PC FILE                                  
**                                                                      
** NOTE: Example requires that Natural Connection is installed.         
************************************************************************
DEFINE DATA LOCAL                                                       
01 PERS VIEW OF EMPLOYEES                                               
  02 PERSONNEL-ID                                                       
  02 NAME                                                               
  02 CITY                                                               
END-DEFINE                                                              
*                                                                       
FIND PERS WITH CITY = 'NEW YORK'                     /* Data selection         
  DOWNLOAD PC FILE 7 CITY NAME PERSONNEL-ID    /* Data download  
END-FIND                                                                
END                                                                    

プログラム PCDOEX1 の出力:

プログラムを実行するとウィンドウが開くため、データがダウンロードされる PC ファイルの名前を指定します。 その後、データが PC にダウンロードされます。

例 2 - COMMAND 節の使用例

次のプログラムで、DOWNLOAD PC FILE ステートメントでの COMMAND 節の使用方法を示します。 最初に、データを受け取る側の PC ファイルの名前が定義されます。 次に、データが選択され、このファイルにダウンロードされます。

** Example 'PCDOEX2': DOWNLOAD PC FILE                                  
**                                                                      
** NOTE: Example requires that Natural Connection is installed.         
************************************************************************
DEFINE DATA LOCAL                                                       
01 PERS VIEW OF EMPLOYEES                                               
  02 PERSONNEL-ID                                                       
  02 NAME                                                               
  02 CITY                                                               
01 CMD (A80)                                   /* Variable for transfer 
END-DEFINE                                     /* of the PC command     
*                                                                       
MOVE 'SET PCFILE 7 DOWN DATA PERS.NCD' TO CMD  /* PC command to define  
*                                                                       
DOWNLOAD PC FILE 6 COMMAND CMD                 /* Command download
*                                                                       
FIND PERS WITH CITY = 'NEW YORK'               /* Data selection   
  DOWNLOAD PC FILE 7 CITY NAME PERSONNEL-ID    /* Data download         
END-FIND                                                                
END

注意:
2 つの連続した DOWNLOAD PC FILE ステートメントでは、PC ファイルの番号は異なっている必要があります。

プログラム PCDOEX2 の出力:

プログラムを実行すると、プログラム内で指定した PC ファイルにデータがダウンロードされます。 ウィンドウは表示されません。

Top of page