戻り値

0xYYZZZZZZ

表5-4　ettransコマンドの戻り値

エラー レベル	YY	ZZZZZZ	意味
I	00	000000	正常に終了しました。
		000008	テスト用のデータを入力しました。変換は正常に終了しました。
W	01	000001	不正文字コードを検出し，スペースに置き換えました。
		000002	要素サイズをオーバーしたためデータをカットしました。
		000004	エラーが発生したが，正常変換できたグループだけ出力しました。
		000008	テスト用のデータを入力しました。
		000010	ログファイルを開けなかったため，デフォルトのログファイル又は標準出力にログを出力しました。
		000020	CII標準又はEIAJ標準のハッシュトータル値がメッセージグループ・トレーラ（MGT）の値と一致しません。
		000040	出口関数の定義に不正があります。
		000080	入力フォーマット以降に入力データがあります。
		000100	「ettrans.ini」の定義に不正があります。
		000000	その他のワーニングエラーです。
E	02	000001	不正文字を検出しました。
		000002	要素サイズをオーバーしました。
		000004	エラーが発生したが，正常変換できたグループだけ出力しました。
		000008	テスト用のデータでエラーが発生しました。
		000000	その他のエラーです。
S	04	000001	ファイル入出力エラーです。
		000002	メモリ不足です。
		000004	出力データのサイズが出力できるメモリアドレスを超えました。
		000008	データ変換処理APIのスレッド固有情報又はMDL情報に不正があります。
		000010	変換できないMDLファイルです（対応ライセンスがありません）。
		000000	その他のシステムエラーです。

（凡例）

I（インフォメーション）：正常に終了しました。

W（ワーニング）：変換中にワーニングレベルのエラーが発生しましたが，データ変換は終了しました。

E（エラー）：変換中に続行できないレベルのエラーが発生し，データは最後まで変換されないまま途中で終了しました。

S（システムエラー）：トランスレータ内部で致命的エラーが発生し，データは最後まで変換されないまま途中で終了しました。

トランスレータの戻り値の注意事項を次に示します。

• 同じレベルのエラーが複数発生した場合，それぞれの値の論理和が出力されます。
  例えば，不正文字コードと要素サイズオーバーの両方のワーニングが発生した場合の戻り値は，「0x01000001」と「0x01000002」の下2桁の論理和となる「0x01000003」が出力されます。
  
• 異なるレベルのエラーが複数発生した場合，原則として，論理和は取らずに上位エラーの戻り値が出力されます。エラーレベルの優先順位を次に示します。
  S：システムエラー＞E：エラー＞W：ワーニング＞I：インフォメーション
  ただし，下2桁に「0x00000008」（テスト用データを入力した）が含まれる場合は「0x00000008」との論理和を取った値になります。
  
• システムレベルのエラー（0x04ZZZZZZ）が発生した場合，下6桁の値についてはほかの値との論理和は取りません。
• 戻り値として「0x01000008」又は「0x02000008」を出力するのは，テスト用の入力データとして，CII標準又はUN/EDIFACTのデータを入力した場合だけです。
• 戻り値「0x04000008」は，APIによる変換実行時だけ出力されます。
• 実行時オプション「-RELVL」を指定した場合，ettransコマンドは，戻り値の代わりにエラーレベルを返します。エラーレベルについては，「表5-3　エラーレベルと戻り値の対応」を参照してください。