USAD ゲート、INQUIRE_DEFAULT_USER 関数

USAD ゲートの INQUIRE_DEFAULT_USER 関数は、DFLTUSER システム初期設定パラメーターで指定されたデフォルト・ユーザーの属性に関する照会を行う場合に使用します。

出力パラメーター

REASON
RESPONSE が DISASTER である場合、以下の値が返されます。
  • ABEND
  • ADD_TIMEOUT_ENTRY_FAILED
  • DEL_EXPIRED_ENTRY_FAILED
  • DEL_TIMEOUT_ENTRY_FAILED
  • DIR_MANAGER_ADD_FAILED
  • DIR_MANAGER_DELETE_FAILED
  • DIR_MANAGER_LOCATE_FAILED
  • EXTRACT_FAILED
  • FREEMAIN_FAILED
  • GETMAIN_FAILED
  • INQUIRE_PW_DATA_FAILED
  • LOOP
  • SEC_DOMAIN_ADD_FAILED
  • SEC_DOMAIN_DELETE_FAILED
RESPONSE が EXCEPTION である場合、以下の値が返されます。
  • ACCOUNT_INVALID
  • ALREADY_SIGNED_ON
  • APPLICATION_NOTAUTH
  • DEFAULT_USER_TOKEN
  • ENQ_LIMIT_EXCEEDED
  • ENTRY_PORT_NOTAUTH
  • ESM_INACTIVE
  • ESM_TRANQUIL
  • GROUP_ACCESS_REVOKED
  • INVALID_GROUPID
  • INVALID_NEW_PASSWORD
  • INVALID_OIDCARD
  • INVALID_PARAMETERS
  • INVALID_PASSWORD
  • INVALID_USER_TOKEN
  • INVALID_USERID
  • NEW_PASSWORD_REQUIRED
  • OIDCARD_REQUIRED
  • PASSWORD_REQUIRED
  • SECLABEL_CHECK_FAILED
  • SECURITY_INACTIVE
  • UNKNOWN_ESM_RESPONSE
  • USER_NOT_LOCATED
  • USERID_NOT_DEFINED
  • USERID_NOT_DETERMINED
  • USERID_NOT_FOUND
  • USERID_NOT_IN_GROUP
  • USERID_REVOKED
RESPONSE が INVALID である場合、以下の値が返されます。
  • INVALID_FORMAT
  • INVALID_FUNCTION
対応
ドメイン呼び出しが正常に実行されたかどうかを示します。 詳細は 、「ドメインインターフェースのRESPONSEパラメータ」 を参照してください。
ACEE_PTR
オプション・パラメーター
ユーザーがサインオンしたときに外部ユーザー (ESM) によって生成される制御ブロックである、アクセス制御環境エレメントへのポインター。 ユーザーがサインオンしていない場合、 CICS® のアドレスが返されます。 ACEE が存在しない場合、CICS は、ポインター参照をヌル値 (X'FF000000') に設定します。
CURRENT_GROUPID
オプション・パラメーター
は、ユーザーID（SECURITY_TOKEN値で指定）が割り当てられているRACF®の識別子であり、1から10までの英数字です。
CURRENT_GROUPID_LENGTH
オプション・パラメーター
8 ビット長の GROUPID 値。
NATIONAL_LANGUAGE
オプション・パラメーター
このユーザー ID で使用する各国語を識別する 3 文字のコード。 それは、 国家語コード（3文字） の値のいずれかを持つことができます。
OPERATOR_CLASSES
オプション・パラメーター
ユーザーが所属するオペレーター・クラスを識別します。 これは 24 ビットの値で、各ビットは、ユーザーがそのクラスのメンバーであるかどうかを判別します。
OPERATOR_IDENT
オプション・パラメーター
このユーザー ID のオペレーター ID コード (1 から 3 文字の英数字)。
OPERATOR_PRIORITY
オプション・パラメーター
このユーザー ID のオペレーター優先順位の値 (0 から 255 の範囲で、255 が最も優先順位が高い)。
TIMEOUT
オプション・パラメーター
ユーザーが最後に端末を使用してから CICS がその端末を「タイムアウト」にするまでの経過時間を示す分数 (0 から 60 の範囲)。
  1. CICS は、この値を 5 分単位に切り上げます。
  2. TIMEOUT 値が 0 の場合、端末をタイムアウトにしないことを意味します。
USERID
オプション・パラメーター
ユーザーの ID (1 から 10 文字の英数字で指定するユーザー ID)。
USERID_LENGTH
オプション・パラメーター
USERID 値の長さ。
USERNAME
オプション・パラメーター
ユーザーの属性が入れられるオプションのバッファー。
XRF_REFLECTABLE
オプション・パラメーター
XRF のテークオーバーの後に CICS が ユーザー ID をサインオフさせるかどうかを示します。
パラメーターの値は以下のとおりです。
  • NO
  • YES