READコマンドは、指定したメッセージ内容を作業リストに配置します。作業リスト定義は、予想されるコンテンツに適していなければなりません。例えば、テキスト・コンテンツを読み込む場合、作業リストには1つのフィールドが必要です。テキスト以外のコンテンツ(区切り文字の値を含むコンテンツなど)を読み込む場合、そのコンテンツの最大列数に対応できるように作業リストを定義する必要があります。
ENCODINGキーワードとCONTENTキーワードにより、コンテンツ処理要件が制御されます。
構文：
コマンド | キーワード | 値 | 開発者用メモ |
|---|---|---|---|
READ | OBJECT | *TEXT | メッセージの本文が作業リストに読み込まれることを示します。メッセージのコンテンツタイプがtext/またはmultipart/で始まらない場合、コマンドはステータス・フィールドにNOTEXTを返します。 |
*ATTACHMENT | これを使って、作業リストに読み込む特定のファイルを指定します。この値とENTRYキーワードまたはSELECTキーワードを組み合わせて使用して、保存する添付ファイルを特定します。キーワードに ENTRY もしくは SELECT のどちらも指定されていない場合は、最初の添付ファイルが読み込まれます。現在のメッセージに添付ファイルが関連付けられていない場合、コマンド・ステータスはNOATTACHMENTが返されます。 | ||
ENTRY | 整数 | 読み込む添付ファイルのファイル番号を指定します。 各添付ファイルに割り当てられる番号は、送信者がメールに添付ファイルを追加する順序で決まります。 デフォルト値は1です。 | |
SELECT | 値 | 添付ファイル名をもとに、読み込む添付ファイルを選択します。 | |
ENCODING | エンコーディング | コンテンツをUnicode文字列変換する際に適用するエンコーディングを指定します。ENCODINGキーワードのデフォルト値は*DEFAULTです。 | |
CONTENT | *TEXT | 添付ファイルのコンテツをテキストとして読み込み、作業リストに入れます。 | |
*SV | 添付ファイルのコンテツを区切り値として読み込み、作業リストに入れます。 | ||
*CSV | 添付ファイルのコンテツをCSVとして読み込み、作業リストに入れます。 | ||
*TSV | 添付ファイルのコンテツをTSVとして読み込み、作業リストに入れます。 | ||
SEPARATOR | 任意。詳細は、「SEPARATOR」を参照してください。 | ||
SVROW | 任意。詳細は、「SVROW」を参照してください。 | ||
SVROWLIMIT | 任意。詳細は、「SVROWLIMIT」を参照してください。 | ||
SVMODE | 任意。詳細は、「SVMODE」を参照してください。 | ||
SVHEAD | 任意。詳細は、「SVHEAD」を参照してください。 | ||
NUMBERFORMAT | | 任意。詳細は、「NUMBERFORMAT」を参照してください。 |
例
READ OBJECT(*TEXT) #WRKLST(TXT)
READ OBJECT(*ATTACHMENT) ENTRY(2) CONTENT(*TEXT) #WRKLST(TXT)