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

4.2.12 mc_send_data

[記述形式]

#include  <lu62verb.h>
u_long  mc_send_data(MC_SEND_DATA *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    request_to_send_received;                 /*[OUT]*/ 
  u_char    map_name[MAX_MAP_NAME+1];                 /*[IN]*/
  u_char    type;                                     /*[IN]*/
  u_char    nbio;                                     /*[IN]*/
  long      length;                                   /*[IN]*/
  u_char    *data;                                    /*[IN]*/
｝MC_SEND_DATA; 

[説 明]

相手トランザクションプログラムにデータを送信します。自トランザクションプログラムの会話は送信状態でなければいけません。自トランザクションプログラムの送信しようとしているデータは、その長さが送信RU長を超えるか、または自トランザクションプログラムがその送信バッファをフラッシュするバーブを発行するまで相手トランザクションプログラムには送信されず、自LUの送信バッファに保留されます。

[要求時のパラメタ]

• conv_id

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

• map_name

0を指定します。

• type

SUB_NONEを指定します。

• nbio

BLOCKINGを指定します。

• length

送信するデータの長さを指定します。0を指定すると、データは送信されず、dataパラメタは無視されます。

• data

送信するデータのアドレスを指定します。

[復帰時のパラメタ]

• return_code

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

OK(0x00000000):

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

ALLOCATION_FAILURE_NO_RETRY(0x00040003):

一時的でない理由により、会話を割り当てることができませんでした。

DEALLOCATE_ABEND(0x00080001):

相手トランザクションプログラムが、サブタイプにSUB_ABENDを伴うmc_deallocateバーブを発行しました。

SHM_FAILURE(0x00FF0003):

共用メモリに関する処理で異常が発生しました。

PARAMETER_ERROR(0x000A0000):

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

BAD_CONV_ID(0x000A0008):

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

STATE_CHECK_BAD_STATE(0x00100001):

状態エラーが発生しました。本バーブは、会話の状態が送信状態のときにのみ発行することができます。

RESOURCE_FAILURE_NO_RETRY(0x000E0001):

リトライ不可能なエラーが発生しました。

SESSION_DEACTIVATED(0x00FF0005):

セションが切断されました。

LU62_DEACTIVATE(0x00FF0007):

LU6.2会話サービスが非活性化状態です。

SYSTEM_ERROR_NO_RETRY(0x00FF0009):

システムでリトライ不可能なエラーが発生しました。

VCP_ERROR_NO_RETRY(0x00FF000C):

FNA-BASEでリトライ不可能なエラーが発生しました。

DLC_ERROR_NO_RETRY(0x00150010):

下位ドライバでリトライ不可能なエラーが発生しました。

PROG_ERROR_PURGING(0x00050003):

相手トランザクションプログラムが、タイプSUB_PROGのmc_send_errorバーブを発行し、かつ相手トランザクションプログラムの会話は送信状態になるまでのすべてのデータを廃棄しています。自トランザクションプログラムの会話が受信状態になったときに、相手トランザクションプログラムの会話は送信状態になります。

VCP_DEACTIVATE(0x00FF000D):

FNA-BASEが停止されました。

INCONSISTENCY_IN_LU62(0x00FF0008):

LU6.2会話サービスで異常が発生しました。

• request_to_send_received

相手トランザクションプログラムから、request_to_send(送信権の要求)を受信したか否かが通知されます。以下のような値が通知されます。

REQUEST_TO_SEND_NOT_RECEIVED:

request_to_sendを受信していません。

REQUEST_TO_SEND_RECEIVED:

request_to_sendを受信しました。