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

4.2.13 mc_send_error

[記述形式]

#include  <lu62verb.h>
u_long  mc_send_error(MC_SEND_ERROR *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    type;                                     /*[IN]*/
  u_char    dont_flush_fmh7_on_ec;                    /*[IN]*/
  u_char    rsvd0[1];                                 /*[RESERVED]*/
  u_long    sense_code_in_fmh7;                       /*[IN]*/
  long      log_data_length;                          /*[IN]*/
  u_char    *log_data;                                /*[IN]*/
｝MC_SEND_ERROR;

[説 明]

本バーブは、会話中に誤りを検出したことを相手トランザクションプログラムに通知する場合、または応答要求に対して否定応答を返す場合に使用します。送信状態で本バーブを発行した場合、送信バッファに保留されている情報はフラッシュされます。

本バーブは、自トランザクションプログラムの会話が以下に示す状態のときに発行することができます。

• CONV_SEND
• CONV_RECEIVE
• CONV_RECEIVE_CONFIRM
• CONV_RECEIVE_CONFIRM_SEND
• CONV_RECEIVE_CONFIRM_DEALL

自トランザクションプログラムの会話が受信状態(CONV_RECEIVE、CONV_RECEIVE_CONFIRM、CONV_RECEIVE_CONFIRM_SEND、またはCONV_RECEIVE_CONFIRM_DEALL)で、かつ本バーブが正常終了した場合、自トランザクションプログラムの会話は送信状態になります。

[要求時のパラメタ]

• conv_id

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

• type

本バーブの動作種別を指定します。以下の値が指定できます。

SUB_PROG : アプリケーションプログラムエラーが発生しました。相手トランザクションプログラムは、復帰コードとして以下に示す値のうちの一つを受け取ります。

PROG_ERROR_NO_TRUNC
PROG_ERROR_PURGING
PROG_ERROR_NO_PURGING

• dont_flush_fmh7_on_ec

0を指定します。

• sense_code_in_fmh7

0を指定します。

• log_data_length

0を指定します。

• log_data

0を指定します。

[復帰時のパラメタ]

• return_code

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

OK(0x00000000):

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

ALLOCATION_FAILURE_NO_RETRY(0x00040003):

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

DEALLOCATE_ABEND(0x00080001):

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

PARAMETER_ERROR(0x000A0000):

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

BAD_CONV_ID(0x000A0008):

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

STATE_CHECK_BAD_STATE(0x00100001):

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

RESOURCE_FAILURE_NO_RETRY(0x000E0001):

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

LU62_DEACTIVATE(0x00FF0007):

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

SESSION_DEACTIVATED(0x00FF0005):

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

SYSTEM_ERROR_NO_RETRY(0x00FF0009):

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

VCP_ERROR_NO_RETRY(0x00FF000C):

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

DLC_ERROR_NO_RETRY(0x00150010):

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

PROG_ERROR_NO_TRUNC(0x00050001):

相手トランザクションプログラムが、送信状態の会話でタイプSUB_PROGのsend_errorバーブを発行しました。

PROG_ERROR_PURGING(0x00050003):

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

VCP_DEACTIVATE(0x00FF000D):

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

INCONSISTENCY_IN_LU62(0x00FF0008):

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

• rquest_to_send_received

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

REQUEST_TO_SEND_NOT_RECEIVED:

request_to_sendを受信していません。

REQUEST_TO_SEND_RECEIVED:

request_to_sendを受信しました。