区切り文字付きインポート・ファイルに関する注 (CPYFRMIMPF コマンド)

• 文字フィールドのすべての先行ブランクおよび末尾ブランクは、 ストリング区切り文字で囲まれていない限り、RMVBLANK パラメーターに基づいて廃棄されます。
• RMVBLANK *NONE を指定しない限り、ブランクのみで構成されるフィールドは、単一のブランク文字からなるフィールドとして解釈されます。
• 数字データ内にブランクを組み込むことはできません。
• ブランクをフィールドまたはレコードの区切り文字として選択することはできません。

RMVBLANK パラメーターには以下のオプションがあります。

• *NONE: すべての先行ブランクと末尾ブランクが保持されます。
• *LEADING: 先行ブランクが削除されます。これはデフォルト値です。
• *TRAILING: 末尾ブランクが削除されます。
• *BOTH: 先行ブランクと末尾ブランクが削除されます。

• 2 つの隣接するフィールド区切り文字 (区切り文字の間にデータがない)。
• 2 つの隣接するストリング区切り文字 (区切り文字の間にデータがない)。
• 後にレコード区切り文字が続くフィールド区切り文字 (間にデータがない) 空ストリング。

フィールドが NULL である場合、以下の説明が当てはまります。

• レコードの出力フィールドが NULL 可能でなく、 インポートが NULL フィールドである場合、 レコードはコピーされず、エラーが表示されます。

• フィールド区切り文字には、レコード区切り文字と同じ文字を使用することはできません。
• フィールドまたはレコードの区切り文字にブランクを使用することはできません。
• ストリング・エスケープ文字 STRESCCHR(*NONE) が指定されている場合、ストリング区切り文字ですべてのフィールドを囲むことができます。 ストリング区切り文字を文字ストリング内に入れることはできません。
• ストリング区切り文字には、レコード区切り文字と同じ文字を使用することはできません。
• ストリング区切り文字またはストリング・エスケープ文字として、フィールド区切り文字、レコード区切り文字、小数点、日付区切り記号、または時刻区切り記号と同じ文字を使用することはできません。
• コピー元のデータ・タイプが CHARACTER、OPEN、EITHER、 または ONLY である場合、 すべての 2 バイト・データは、 ストリング区切り文字またはシフト文字の中に入っていなければなりません (OPEN、EITHER、 ONLY データ・タイプの場合)。
  注: ストリング区切り文字は、 先行ブランクや末尾ブランクよりも優先順位が低くなっています。
• 区切り文字のデフォルトは、以下のとおりです。
  • ストリング: *DBLQUOTE (二重引用符)
  • フィールド: , (コンマ)
  • 小数点: . (ピリオド)
  • レコード: *EOR (レコードの終わり)
• ストリング区切り文字がストリングに含まれる場合、ストリング内のストリング区切り文字の前に、STRESCCHR パラメーターで指定されたストリング・エスケープ文字を使用してください。

• 数字フィールドは、10 進様式または指数様式でインポートできます。
• 小数点の右側にあるデータは、出力データ様式によっては切り捨てられる場合があります。
• 小数点は、ピリオドまたはコンマのいずれかです (コマンド・オプション)。
• 符号付き数字フィールドがサポートされています (+ または -)。

• 出力フィールド内に入りきらないフィールドは切り捨てられます。 システムは、診断メッセージを送信します。
• 空ストリングは、 区切り文字間にデータがない 2 つのストリング区切り文字として定義されます。
• ある文字を開始または終了のストリング区切り文字としてシステムに認識させるには、 RMVBLANK オプションの適用後にその文字がフィールド内の最初または最後の文字にならなければなりません。 たとえば、区切り文字として引用符 (') が付いている 'abc' は、abc と同じです。

• データは、コピー元ファイルからコピー先ファイルにコピーされます。 データのいずれかが無効である場合、マッピング・エラーが生成されます。
• シフトアウト文字とシフトイン文字との間にあるデータは、2 バイト・データとして処理されます。 また、このデータは、区切り文字としては解析されません。 この場合、シフト文字は "ストリング区切り文字" になります。

• コピー元ファイルのデータは、 コピー元ファイルの CCSID によってバッファーに読み取られます。 バッファー内のデータは検査され、 コピー先ファイルに書き込まれます。 コピー先ファイルの CCSID が使用されない限り、 オープン・コピー先ファイルの CCSID は、 コピー元ファイルの値に設定されます。

  コピー先ファイル CCSID が使用されると、 データはその CCSID に変換されます。 コピー先ファイル・フィールドの CCSID が 65535 であれば、コピー先 CCSID (TOCCSID) パラメーターで指定された CCSID にデータが変換されます。

  コピー元ファイルがテープ・ファイルであり、 FROMCCSID(*FILE) が指定されている場合、 以下のいずれかの制限が適用されます。

  • ジョブ CCSID が使用されます。
  • コピー元ファイル CCSID がユーザーによって要求されます。
• コマンドで渡された文字データ (区切り文字) は、 コピー元ファイルの CCSID に変換されます。 これにより、 コピー元ファイル・パラメーターの文字データとコマンド・パラメーターの文字データとの互換性が実現します。

• IBM® i オペレーティング・システムによってサポートされているすべての日付様式をインポートすることができます (*ISO、*USA、*EUR、*JIS、*MDY、*DMY、 *YMD、*JUL、および *YYMD)。
• 日付フィールドをタイム・スタンプ・フィールドにコピーすることができます。

• IBM i オペレーティング・システムによってサポートされているすべての時刻様式をインポートできます (*ISO、*USA、*EUR、*JIS、*HMS)。
• 時刻フィールドをタイム・スタンプ・フィールドにコピーすることができます。

LOB データのインポート例:

FDF ファイル:

COLCHAR10        1         10         42
COLLOB          12         40         44
*END

データ・ファイルのレコード長は 44 文字になり、 内容は以下のようなデータになります。

0        1         2         3         4
12345678901234567890123456789012345678901234
aaaaaaaaaa   /lobdata/lob1.dat           N N
bbbbbb       /lobdata/lob2.dat           N N
             /lobdata/lob3.dat           Y N
cccccccccc                               N Y

相対レコード番号は、 単一スレッドが使用され、 インポート・ファイルに削除レコードが含まれていない場合にのみ維持されます。 コピー元ファイルが分散物理ファイルまたは論理ファイルである場合、システムでは、単一プロセスでコピー操作が実行されます。

レコード数が 50 000 より少ないファイルは、1 つのジョブのみを使用します。