Netcompo アプリケーション会話サービス 2.1.1 LU6.2会話サービス編 - Solaris OE -

4.2.6 mc_get_attributes

[記述形式]

#include  <lu62verb.h>
u_long  mc_get_attributes(MC_GET_ATTRIBUTES *parm);

[パラメタブロックの形式]

typedef struct {
  u_char    sys_rsvd0;                                    /*[RESERVED]*/
  u_char    sys_rsvd1;                                    /*[RESERVED]*/
  u_short   sys_rsvd2;                                    /*[RESERVED]*/
  u_char    sys_rsvd3[8];                                 /*[RESERVED]*/
  u_long    return_code;                                  /*[OUT]*/ 
  u_long    conv_id;                                      /*[IN]*/
  u_char    state;                                        /*[OUT]*/ 
  u_char    tp_name_is_iso;                               /*[OUT]*/ 
  u_char    tp_name[MAX_TP_NAME+1];                       /*[OUT]*/ 
  u_char    pu_name[MAX_PU_NAME+1];                       /*[OUT]*/ 
  u_char    lu_local_address;                             /*[OUT]*/ 
  u_char    partner_lu_name[MAX_FQL_LU_NAME+1];           /*[OUT]*/ 
  u_char    mode_name[MAX_MODE_NAME+1];                   /*[OUT]*/ 
  u_char    unique_session_name[MAX_UNIQUE_SESS_NAME+1];  /*[OUT]*/ 
  u_char    sync_level;                                   /*[OUT]*/ 
  u_char    rsvd0[2];                                     /*[RESERVED]*/
｝MC_GET_ATTRIBUTES; 

[説 明]

指定されたマップ会話に関する情報を獲得します。本バーブは、会話中のいかなる状態のときであっても発行することができ、状態の変更を伴いません。

[要求時のパラメタ]

• conv_id

会話識別子を指定します。

[復帰時のパラメタ]

• return_code

復帰値が通知されます。以下のような値が通知されます。

OK(0x00000000):

バーブが正常終了しました。

PARAMETER_ERROR(0x000A0000):

パラメタエラーが発生しました。

BAD_CONV_ID(0x000A0008):

指定された会話識別子が無効です。

• state

現在の会話の状態が通知されます。以下のような値が通知されます。

CONV_LISTEN:

appc_listenバーブが発行されています。会話は作成されていません。この値は、conv_idパラメタにlisten識別子を指定した場合に通知されます。

CONV_SEND:

会話は送信状態です。

CONV_RECEIVE:

会話は受信状態です。

CONV_RECEIVE_CONFIRM:

会話は確認状態です。

CONV_RECEIVE_CONFIRM_SEND:

会話は確認状態(送信確認状態)です。

CONV_RECEIVE_CONFIRM_DEALL:

会話は確認状態(会話終了確認状態)です。

CONV_END_CONV:

会話は会話終了状態です。

• tp_name_is_iso

CODE_IS_ASCIIが通知されます。

• tp_name

現在の会話のトランザクションプログラム名が通知されます。このフィールドの値は、現在の会話がmc_allocateバーブで作成されたときは、mc_allocateバーブのtp_nameパラメタで指定された値が通知され、appc_acceptバーブで作成されたときは、相手トランザクションプログラムからの会話開始要求に含まれるトランザクションプログラム名が通知されます。トランザクションプログラム名は、16文字以内の、NULLで終了する文字列です。

• pu_name

自CP名が通知されます。CP名は、8文字以内の、NULLで終了する文字列です。

• local_lu_address

0が通知されます。

• partner_lu_name

相手グローバルLU名が通知されます。このフィールドは、ASCIIコードで17文字以内の、NULLで終了する文字列です。相手グローバルLU名が不明のときは、NULL値が通知されます。

• mode_name

現在の会話のモード名が通知されます。このフィールドは、ASCIIコードで8文字以内のNULLで終わる文字列です。

• unique_session_name

ユニークセション名が通知されます。このフィールドは、ASCIIコードで8文字以内の、 NULLで終わる文字列です。ユニークセション名が不明のときは、NULL値が格納されます。

• sync_level

指定された会話の同期レベルが通知されます。以下のような値が通知されます。

SYNC_NONE:

トランザクションプログラムは、この会話においてconfirmバーブ、あるいはsync_point(未サポート)バーブを発行することができません。

SYNC_CONFIRM:

トランザクションプログラムは、この会話において確認処理を行うことはできますが、sync_point(未サポート)バーブを発行することはできません。