DOWNLOAD PC FILE

DOWNLOAD
WRITE

PC
WORK

[FILE] work-file-number

[VARIABLE] operand1

COMMAND operand2

SYNC
ASYNC

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

関数
構文説明
例

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

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

関連機能グループ：ワークファイル／PC ファイルの制御

関数

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

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

構文説明

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

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

ワークファイルタイプ ENTIRECONNECTION または TRANSFER を使用しているとき、operand1 のフォーマットを C または G にすることはできません。

構文要素の説明：

構文要素	説明
`work-file-number`	ワークファイル番号：使用するワークファイル番号を指定します。この番号は、Natural に対する定義に従って、PC のワークファイル番号の 1 つに対応している必要があります。
`VARIABLE`	変数のフォーマット： PC ファイルに書き込まれるレコードは可変フォーマットです。可変レコードは PC のスプレッドシート形式に変換できません。
`operand1`	フィールド指定： `operand1` では、PC にダウンロードするフィールドを指定します。
`COMMAND`	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 オプション： `SYNC` では、`COMMAND` の実行と終了後に PCから Natural に制御を返すことを指定します。`SYNC` を使用すると、例えば、ファイル転送を開始する前にコマンド `SET PCFILE` を確実に実行することができます。
`ASYNC`	ASYNC オプション： `ASYNC` では、`COMMAND` の実行が終了したかどうかに関係なく、PC から Natural に制御を直ちに返すことを指定します。

例 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 ファイルにデータがダウンロードされます。ウィンドウは表示されません。