PLISAXA サブルーチン

目的

プログラムバッファー内にある XML ドキュメントを処理するために XML パーサーを呼び出します。

構文

CALL PLISAXA(e, p, x, n, c)

パラメーター

e は、イベント構造体です。

p は、パーサーからイベント関数に渡すポインター値またはトークンです。

x は、処理対象の XML ドキュメントを含むバッファーのアドレスです。

n は、x で指定したバッファー内のデータのバイト数です。

c は、処理対象の XML ドキュメントのコードページを指定する数値式です。

説明

PLISAXA 組み込みサブルーチンは、libmxml2 XML パーサーに基づく内部 SAX 解析を提供します。24 種類のイベントに対応しており、XML 文字列をポイントするメモリアドレスを操作できます。この文字列のコードは ASCII でも EBCDIC でも構いません。

例

この例は、PLISAXA 組み込みサブルーチンの使用法を示しています。この例では、PLISAXA を呼び出すメインルーチンのみが示されており、イベント構造体や型宣言は示されていません。

dcl token       char(8);
dcl xmlDocument char(4000) var;
xmlDocument =
    '<?xml version="1.0" standalone="yes"?>'
||  '<!--This document is just an example-->'
||  '<sandwich>'
||  '<bread type="baker&quot;s best"/>'
||  '<?spread please use real mayonnaise ?>'
||  '<meat>Ham &amp; turkey</meat>'
||  '<filling>Cheese, lettuce, tomato, etc.</filling>'
||  'We should add a <relish> element in future!'.
||  '</sandwich>'
||  'junk';
call plisaxa( eventHandler,
              addr(token),
              addrdata(xmlDocument),
              length(xmlDocument) );
end;

制約事項

-ebcdic オプションを使用してプログラムをコンパイルする場合、コールバックイベントロジックでは、入力フォーマットが EBCDIC であってもコールバックに渡されるデータは ASCII であることが考慮されている必要があります。このため、データは使用前にコールバック内で変換される必要があります。さらに、FIXED BIN(31) として渡されるリファレンス値はすべて、ASCII 文字エンコーディング用です。

UNIX では、XML 入力が EBCDIC で、左角かっこおよび右角かっこ ([] など) を含んでおり、その値が X'BA' および X'BB' である場合、これらのルーチンを変換するためには、独自のカスタムコードセットモジュールを作成する必要があり、それらを実行する際には、カスタムコードセットをポイントするように環境変数 MFCODESET を設定する必要があります。これは ASCII 入力には適用されません。

Intel Chip 上でプログラムが動作している場合、そのプログラムは -bigendian コンパイラオプションを使用してビルドされたものと見なされます。-bigendian コンパイラオプションを使用せずにプログラムをコンパイルした場合は、使用前に -bigendian に対するパラメータータイプの変換が必要になります。

次に、既存の z/OS ベースのアプリケーションを移行する場合の考慮事項を示します。

PLISAXA および PLISAXB イベント構造の一部である (ただし PLISAXC の一部でない) イベント unknown_attribute_reference (E20) が IBM の SAX プロセッサと同じコンテンツをともなって生成されますが、解析のより早い段階で発生します。
イベント unknown_content_reference (E21) の参照は、実際の値に拡張されます。
2 つのイベント start_of_prefix_mapping (E22) および end_of_prefix_mapping (E23) は、IBM の PLISAXA および PLISAXB 機能によって記述されたアプリケーションとの互換性を維持するために現時点ではサポートされません。
SAX パーサーを使用する場合は、イベント exception (E24) は 1 回のみ発生してエラーを示し、exception イベントを文字ごとに 1 回発生させることは行いません。イベント exception (E24) の Micro Focus エラーコードのリストについては、「XML パーサーの例外イベントエラーコード」トピックを参照してください。