TRANSFER_MS_DATA

TRANSFER_MS_DATA動詞は、ネットワーク管理ベクトル トランスポート (NMVT) データを含む SNA 要求ユニットを構築します。 動詞は、一元的な問題の診断と解決のために、NMVT データを NetView に送信できます。 データはローカル監査ファイルに記録されます。

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

構文

  
struct transfer_ms_data {  
    unsigned short       opcode;  
    unsigned char        data_type;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        options;  
    unsigned char        reserv3;  
    unsigned char        origntr_id[8];  
    unsigned short       dlen;  
    unsigned char FAR *  dptr;  
};  

メンバー

オペコード
指定されたパラメーター。 操作コードを識別する動詞SV_TRANSFER_MS_DATA。

data_type
指定されたパラメーター。 この動詞によって提供されるデータの種類を指定します。

• SV_NMVTを使用して NMVT (NS ヘッダー、主要なネットワーク管理ベクトル、サブベクトルを含む) を生成します。

• SV_ALERT_SUBVECTORSを使用して、NS ヘッダーまたは主要な NMVT ベクトルを使用せずに、適切な形式でアラートのデータを含む RU を生成します。

• SV_PDSTATS_SUBVECTORSを使用して、NS ヘッダーまたは主要な NMVT ベクトルを使用せずに、問題判別統計のデータを含む RU を適切な形式で生成します。

• SV_USER_DEFINEDを使用してユーザー定義データを生成する。このデータはエラー ログに記録されますが、診断用に構成された接続のシステム サービス制御ポイント物理ユニット (SSCP-PU) セッションでは送信できません。

  reserv2
  予約済みフィールド。

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

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

  オプション
  指定されたパラメーター。 個々のビットをオンまたはオフにして、目的のオプションを指定します。 (data_typeが SV_USER_DEFINED に 設定されている場合 、ビット 1、2、3 は無視されます)。「解説」セクションを参照してください。

  reserv3
  予約済みフィールド。

  origntr_id
  指定されたパラメーター。 TRANSFER_MS_DATAを発行するコンポーネントの名前を指定します。 このパラメーターは省略可です。 システムで無視する場合は、0x00に設定します。

  dlen
  指定されたパラメーター。 この動詞に指定するデータの長さを指定します。 データの合計長 (ユーザーが指定したデータと追加されたヘッダーまたはサブベクトル) は、1 つの RU に収まる必要があります。 RU の最大長は 512 バイトです。

  dptr
  指定されたパラメーター。 送信するデータのアドレスを指定します。

リターン コード

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

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

SV_DATA_EXCEEDS_RU_SIZE

セカンダリ リターン コード。送信するデータが長すぎます。 ユーザー指定のデータとヘッダーと追加されたサブベクトルの長さは、512 バイト以下の単一の RU に収まる必要があります。

SV_INVALID_DATA_SEGMENT

セカンダリ リターン コード。 dptr が指すバッファーが読み取り可能なセグメントではなかったか、セグメント境界を超えて拡張されました。

SV_INVALID_DATA_TYPE

セカンダリ リターン コード。 data_type パラメーターに無効な値が含まれていました。

SV_STATE_CHECK
プライマリ リターン コード。無効な状態で発行されたため、動詞は実行されませんでした。

SV_SSCP_PU_SESSION_NOT_ACTIVE

セカンダリ リターン コード。NMVT が送信されませんでした。SSCP-PU セッションがアクティブでなかったか、診断情報を受信するように構成されたノードがアクティブでなかったか、ネットワーク管理接続が構成されていません。

SV_COMM_SUBSYSTEM_NOT_LOADED
プライマリ リターン コード。動詞の処理中に必要なコンポーネントを読み込んだり終了したりできませんでした。 したがって、通信は行われませんでした。 修正措置については、システム管理者に問い合わせてください。

SV_INVALID_VERB
プライマリ リターン コード。 opcode パラメーターが動詞の操作コードと一致しませんでした。 動詞は実行されません。

SV_INVALID_VERB_SEGMENT
プライマリ リターン コード。データ セグメントの末尾を超えて拡張された VCB。

SV_UNEXPECTED_DOS_ERROR
プライマリ リターン コード。次のいずれかの条件が発生しました。

• 動詞の処理中に、Microsoft Windows オペレーティング システムでエラーが発生しました。 オペレーティング システムのリターン コードは、セカンダリ リターン コードを通じて返されました。 問題が解決しない場合は、修正措置についてシステム管理者に問い合わせてください。

• CSV は、より一般的な Windows PostMessage 関数呼び出しではなく、Windows SendMessage 関数呼び出しを発行する別のアプリケーションによって呼び出されたメッセージ ループから発行されました。 動詞の処理は実行できません。

• SendMessage がアプリケーションを呼び出したときに CSV が発行されました。 アプリケーションが SendMessage で呼び出されたかどうかを確認するには、 InSendMessage Windows API 関数呼び出しを使用します。

  SV_CANCELLED
  プライマリ リターン コード。このコードは、 WinCSVCleanup 呼び出しによってシャットダウンされたときに非同期動詞に対して返されます。

  SV_SERVER_RESOURCE_NOT_FOUND
  プライマリ リターン コード。要求された関数を提供できる通信サーバーが見つかりませんでした。

  SV_SERVER_RESOURCES_LOST
  プライマリ リターン コード。機能を提供していた通信サーバーが、接続エラーのために失われました。

  SV_SERVER_CONN_FAILURE

  セカンダリ リターン コード。物理パスの問題により、サーバーへの接続が失われました。たとえば、サーバーの電源がオフになっている可能性があります。

  SV_THREAD_BLOCKING
  プライマリ リターン コード。この動詞は、同時に使用できる同期動詞の最大数を超えています。

注釈

オプションを指定するには、次のようにビットのオンとオフを切り替えます。