文字/ニブル変換 (CSNBXBC および CSNBXCB)

バイナリー・ストリングを文字ストリング (CSNBXBC) に変換したり、または文字ストリングをバイナリー・ストリング (CSNBXCB) に変換したりするには、これらのユーティリティーを使用します。

これらのユーティリティーは AMODE(64) での呼び出しをサポートしていません。

親トピック: ユーティリティー

形式

CALL CSNBXBC(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             text_length,
             source_text,
             target_text,
             code_table)
CALL CSNBXCB(
             return_code,
             reason_code,
             exit_data_length,
             exit_data,
             text_length,
             source_text,
             target_text,
             code_table)

パラメーター

return_code
方向 タイプ
出力 整数

戻りコードは、呼び出し可能サービスの一般的な結果を示しています。 ICSF および暗号化コプロセッサーの戻りコードおよび理由コードに、戻りコードがリストされています。

reason_code
方向 タイプ
出力 整数

理由コードは、アプリケーション・プログラムに返される、呼び出し可能サービスの結果を示しています。 戻りコードにはそれぞれ、特定の処理問題を示すさまざまな理由コードが割り当てられています。 ICSF および暗号化コプロセッサーの戻りコードおよび理由コード に、理由コードがリストされています。

exit_data_length
方向 タイプ
無視される 整数

このフィールドは無視されます。 このパラメーターには 0 を指定することをお勧めします。

exit_data
方向 タイプ
無視される ストリング

このフィールドは無視されます。

text_length
方向 タイプ
入出力 整数

入力では、text_length には source_text の長さを示す整数が含まれています。長さは、ゼロ以外の正の値でなければなりません。出力では、text_length は target_text の長さである整数で更新されます。

source_text
方向 タイプ
入力 ストリング

このパラメーターには変換するストリングが含まれます。

target_text
方向 タイプ
出力 ストリング

呼び出し可能サービスが返す変換されたテキスト。

code_table
方向 タイプ
入力 ストリング

16 バイトの変換テーブル。バイナリーから EBCDIC への変換用のコード・テーブルは X'F0F1F2F3F4F5F6F7F8F9C1C2C3C4C5C6' です。

使用上の注意

これらのサービスは他のサービスと構造が異なります。 これらは呼び出し側のキーおよびモードで、呼び出し側のアドレス・スペース内で実行されます。

これらのいずれかのサービスを実行するために、ICSF はアクティブである必要はありません。これらのサービスに対してプリプロセッシング出口またはポストプロセッシング出口は有効にされず、これらのサービスを実行するときに RACF への呼び出しは発行されません。

必須ハードウェア

この呼び出し可能サービスで必要な暗号化ハードウェアはありません。