パラメーター

return_code
方向 タイプ
出力 整数

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

reason_code
方向 タイプ
出力 整数

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

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

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

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

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

handle
方向 タイプ
入力 ストリング
トークンの場合、最初の呼び出しに対する空ストリング (ブランク)、または後続の呼び出しに対して検出された最後のトークンの 44 バイトのハンドル。

オブジェクトの場合、最初の呼び出しに対するトークンの 44 バイトのハンドル、または後続の呼び出しに対して検出された最後のオブジェクトの 44 バイトのハンドル。

詳細については、『使用上の注意』を参照してください。handle のフォーマットについては ハンドルを参照してください。

rule_array_count
方向 タイプ
入力 整数
rule_array パラメーターで指定されているキーワード数。 この値は 1 または 2 でなければなりません。
rule_array
方向 タイプ
入力 ストリング
制御情報を呼び出し可能サービスに提供するキーワード。 キーワードはそれぞれ、8 バイト・フィールドで左寄せされ、右側にブランクが埋め込まれます。 キーワードはすべて、連続するストレージ内になければなりません。
表 1. トークン・レコード・リストのキーワード
キーワード 意味
処理エンティティー (必須)
TOKEN 呼び出し側が SAF アクセスできるすべてのトークンがリストに含まれていることを指定します。search_template パラメーターは、無視されます。
OBJECT search_template パラメーターに指定されている属性に一致し、呼び出し側が SAF アクセスできる、すべてのオブジェクトのハンドルがリストに含まれていることを指定します。
リスト・オプション (オプション、OBJECT の場合のみ有効)
ALL 呼び出し側がトークンに対して SAF 権限を持っている場合、オブジェクトをリストするとき、検索基準に一致する共通オブジェクトおよび秘密オブジェクトの両方をリストする必要があることを指定します。検索テンプレートには機密属性がない可能性があります。詳細については、『許可』のトピックを参照してください。
search_template_length
方向 タイプ
入力 整数
search_template パラメーターの長さ (バイト)。TOKEN キーワードが指定されている場合、値は 0 でなければなりません。

最大サイズは 32752 バイトです。

search_template
方向 タイプ
入力 ストリング
オブジェクトをリストに追加するために満たす必要のある基準 (属性値) のリスト。search_template_length パラメーターが 0 の場合、基準は検査されません。

attribute_list のフォーマットについては 属性リストを参照してください。

list_length
方向 タイプ
入力 整数
入力では、output_list パラメーターの長さ (バイト)。 出力では、output_list パラメーターに使用されるバイト数。 提供された長さが 1 つのレコードを保持するには不十分な場合、list_length パラメーターはレコードに必要な最小の長さに設定されます。
handle_count
方向 タイプ
入出力 整数
入力では、リストに返すトークンまたはオブジェクト・ハンドルの最大数。正常な呼び出しからの出力では (return_code < 8)、リスト内のトークンまたはオブジェクト・ハンドルの実際の数。
output_list
方向 タイプ
出力 ストリング
トークン名および説明のリストまたは検索基準を満たすオブジェクト・ハンドルのリスト。