GET

GET

GETコマンドは、リモート・ファイルの内容を受け取り、その内容をローカル・ファイルに保存します。FROMキーワードで指定されたファイルは、DATALINKモードを使用してリモートFTPサーバーから取り出されます。ローカル・サーバーは、TOキーワードで指定されたパスを使用してファイルを保管します。

 GET --------- FROM -----------------ファイル・パス------------------>

           >-- TO -------------------ファイル・パス------------------>

                                                           任意

           >-- FROM_ENCODING --------値---------------------->

           >-- TO_ENCODING ----------値---------------------->

           >-- CONVERT -------------- *NO ------------------------>

                                      *YES

           >-- RECORD_SIZE ---------- 1024 ----------------------->

                                      整数

           >-- RECORD_DELIMITER ----- *NONE ---------------------->

                                      *LF

                                      *CRLF

           >-- DATALINK ------------- *PASV ----------------------|

キーワード

コメント/警告

FROMファイルがIBM i の物理ファイルの場合は以下のようになります。

·         RECORD_SIZEは、ファイルの総レコード長に一致しなければなりません。

·         DSPFDコマンドを使用して総レコード長を決定します。

·         ファイルの全フィールドのタイプはCHARになります。

·         ファイル内の削除されたレコードはブランク・レコードとして読み込まれるため、RGZPFMコマンドを使用して、削除されたレコードをファイルから除外します。

通常のストリーム・ファイルも変換できます。

·         各レコード・サイズの読み込み後にデータが変換されます。

·         FROMファイルの内容は、RECORD_SIZE (*NOMAX)オプションを使用しない限り、シングル・バイト・エンコードになります。この場合、ファイルは1回の読み込みで処理され、ファイル内容全体に変換が適用されます。

·         詳細については、「キャリッジ・リターン、ライン・フィード、改行」を参照してください。

例

以下の例では、GETコマンドを使用して、リモート・ファイルの内容を受け取り、その内容をローカル・ファイルに保存します。

RDML

CHANGE FIELD(#JSMCMD) TO('GET TO(order.xml) FROM(/xmldata/order.xml)')

USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG)

RDMLX

#jsmcmd := 'get from(' + #jsmfrom + ') to(' + #jsmto + ')'

use builtin(jsmx_command) with_args(#jsmhdle #jsmcmd) to_get(#jsmsts #jsmmsg)

ILE RPG

c                   eval      jsmcmd = 'get to(order.xml)'

c                             + ' from(/xmldata/order.xml)'

c                   callp     p_jsmcmd(jsmcmd:jsmsts:jsmmsg)