次の方法で共有

GET_LU_STATUS

  • [アーティクル]

GET_LU_STATUS動詞は、特定の論理ユニット (LU) の状態を返します。 この会話動詞は、同期ポイントの会話がサポートされている場合にのみ使用できます。

次の構造体は、 GET_LU_STATUS 動詞で使用される動詞制御ブロック (VCB) について説明します。

構文

  
struct get_type {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned char    plu_alias[8];  
    unsigned short   active_sess;  
    unsigned char    zero_sess;  
    unsigned char    local_only;  
    unsigned char    synchpoint;  
    unsigned char    pool_member;  
    unsigned char    reserv3[7];  
};

メンバー

opcode
指定されたパラメーター。 動詞操作コード (AP_GET_LU_STATUS) を指定します。

opext
このフィールドは、 GET_LU_STATUS 動詞では使用されません。

reserv2
予約済みフィールド。

primary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定されるプライマリ リターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラーコードについては、「リターン コード」を参照してください。

secondary_rc
返されたパラメーター。 動詞の完了時に APPC によって設定されるセカンダリ リターン コードを指定します。 有効なリターン コードは、発行された APPC 動詞によって異なります。 この動詞の有効なエラーコードについては、「リターン コード」を参照してください。

tp_id
指定されたパラメーター。 ローカル トランザクション プログラム (TP) を識別します。 このパラメーターの値は、呼び出し元の TP の TP_STARTED 、または呼び出された TP の RECEIVE_ALLOCATE またはRECEIVE_ALLOCATE_EXによって返されました。

plu_alias
指定されたパラメーター。 この TP が照会している LU の識別子を提供します。 このパラメーターの値は、呼び出し元 TP の MC_ALLOCATE または ALLOCATE によって、または呼び出された TP のRECEIVE_ALLOCATE によって返されました。

local_onlyが AP_YES に設定されている場合は必須ではありません

active_sess
返されたパラメーター。 この LU でアクティブなセッションの数を指定します。

zero_sess
返されたパラメーター。 この LU 上にゼロ セッションがあるかどうかを示します。 値はAP_YESまたはAP_NOです。

active_sess
返されたパラメーター。

zero_sess
返されたパラメーター。

local_only
このフィールドが AP_YES に設定されている場合、plu_aliasを指定する必要はありません。動詞はローカル LU 情報 (syncpoint と default_pool) のみを返します。

synchpoint
返されたパラメーター。

pool_member
このフィールドが AP_YES に設定されている場合、plu_aliasを指定する必要はありません。動詞はローカル LU 情報 (syncpoint と default_pool) のみを返します。

reserv3
予約済みフィールド。

リターン コード

AP_OK
プライマリ リターン コード。動詞は正常に実行されました。

AP_PARAMETER_CHECK
プライマリ リターン コード。パラメーター エラーのため、動詞は実行されませんでした。

AP_BAD_LU_ALIAS

セカンダリ リターン コード。 plu_alias の値が、APPC によって割り当てられた LU と一致しませんでした。

AP_BAD_TP_ID

セカンダリ リターン コード。 tp_id の値が、APPC によって割り当てられた TP 識別子と一致しませんでした。

AP_COMM_SUBSYSTEM_ABENDED
プライマリ リターン コード。次のいずれかの条件を示します。

  • このメッセージ交換で使用されているノードで、ABEND が発生しました。

  • TP と PU 2.1 ノードの間の接続が切断されました (LAN エラー)。

  • TP のコンピューターの SnaBase で ABEND が発生しました。

    ABEND の理由を特定するには、システム管理者がエラー ログを調べる必要があります。

    AP_INVALID_VERB_SEGMENT
    プライマリ リターン コード。VCB がデータ セグメントの終わりを越えています。

    AP_STACK_TOO_SMALL
    プライマリ リターン コード。アプリケーションのスタック サイズが小さすぎて動詞を実行できません。 アプリケーションのスタック サイズを増やしてください。

    AP_CONV_BUSY
    プライマリ リターン コード。どの会話にも、一度に 1 つの未処理の会話動詞しか存在できません。 これは、ローカル TP に複数のスレッドがあり、複数のスレッドが同じ conv_idを使用して APPC 呼び出しを発行している場合に発生する可能性があります。

    AP_UNEXPECTED_DOS_ERROR
    プライマリ リターン コード。ローカル TP からの APPC 呼び出しの処理中に、オペレーティング システムから APPC にエラーが返されました。 オペレーティング システムのリターン コードは、secondary_rc 経由で返されます。 これは、Intel バイトスワップ順で表示されます。 問題が解決しない場合は、システム管理者に問い合わせてください。

解説

TP がこの動詞を発行すると、RESET を除く任意の状態にすることができます。

状態の変更はありません。

GET_LU_STATUSの現在のバージョンでは、アプリケーションがローカル APPC LU の構成パラメーターを取得できます。

RECEIVE_ALLOCATE_EX動詞を発行する前に特定のローカル LU の構成をチェックするには、次の動詞シーケンスを発行する必要があります。

  • TP_STARTED (対象のローカル LU を指定)

  • GET_LU_STATUS (local_onlyを AP_YES に設定)

  • TP_ENDED (AP_SOFT)