この文には次のパラメーターがあります。
パラメーター | 説明 |
---|---|
DataItem | エクスポートするデータを含む COBOL データ項目の識別子。エクスポートするデータのモデル テンプレート ファイルの記述を生成したものと必ずしも同じデータ項目である必要はありませんが、少なくとも記述されたものと同じ大きさである必要があります。この識別子は、エクスポートを行うサブプログラムに渡された連絡データ項目を参照することがあります。この識別子は、アプリケーションにエクスポート領域のテーブルがある場合に、必要な添字付けまたは索引付けで指定されたテーブル要素の識別子にすることもできます。 |
DocumentPointer | この文が正常に完了した後に、生成された XML ドキュメントを文字列として参照する COBOL ポインター データ項目の識別子。 |
DocumentLength | この文が正常に完了した後に、生成された XML ドキュメント (DocumentPointer によって参照される) の長さが含まれる COBOL 数値データ項目の識別子。 |
ModelFileName#DataName | 文字リテラルまたは英数字データ項目の識別子。この値は、次のいずれかです。
|
[StyleSheetName] | 文字リテラルまたは英数字データ項目の識別子。この値は、生成された XML ドキュメントを格納前に変換するために使用する XSLT スタイルシートを含むファイルの名前です。 |
XML EXPORT TEXT 文は、DataItem パラメーターで指定した COBOL データ項目の内容をエクスポートします。データ項目の内容は、ModelFileName#DataName パラメーターで指定した 1 つ以上のファイルを使用して XML ドキュメントに変換され、文字列として出力されます。その文字列のアドレスおよびサイズが、DocumentPointer パラメーターと DocumentLength パラメーターで指定した COBOL データ項目に配置されます。オプションの StyleSheetName パラメーターを指定した場合は、その外部 XSLT スタイルシートを使用してドキュメントが変換されます。この変換は、ドキュメントが生成された後、文字列として格納される前に行われます。
生成された XML ドキュメントを保持するためのメモリ ブロックが割り当てられます。COBOL ポインター データ項目の既存のアドレス記述子は、このメモリ ブロックの記述子によってオーバーライドされます。このメモリが不要になったら、COBOL アプリケーションで XML FREE TEXT を使用して解放する必要があります。
XML-data-group というデータ項目に状態値が返されます。このデータ項目はコピーブック lixmldef.cpy に定義されています。
外部 XSLT スタイルシートを指定しない場合:
XML EXPORT TEXT MY-DATA-ITEM MY-DOCUMENT-POINTER MY-DOCUMENT-LENGTH "MY-MODEL-FILE". IF NOT XML-OK GO TO Z.
外部 XSLT スタイルシートを指定する場合:
XML EXPORT TEXT MY-DATA-ITEM MY-DOCUMENT-POINTER MY-DOCUMENT-LENGTH "MY-MODEL-FILE" "MY-STYLE-SHEET" IF NOT XML-OK GO TO Z.
外部 XSLT スタイルシートとパラメーターを指定する場合:
XML SET XSL-PARAMETERS "MY-COUNT", 7. IF NOT XML-OK GO TO Z. XML EXPORT TEXT MY-DATA-ITEM "MY-DOCUMENT.XML" "MY-MODEL-FILE" "MY-STYLE-SHEET" IF NOT XML-OK GO TO Z.