次の方法で共有

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;  
};

メンバー

opcode
指定されたパラメーター。 操作コードを識別する動詞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 動詞によって異なります。 この動詞の有効なエラーコードについては、「リターン コード」を参照してください。

    options
    指定されたパラメーター。 個々のビットをオンまたはオフにして、目的のオプションを指定します。 (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 バイト以下の 1 つの 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 オペレーティング システムでエラーが発生しました。 オペレーティング システムのリターン コードが、セカンダリ リターン コード経由で返されました。 問題が解決しない場合は、システム管理者に是正措置について問い合わせてください。

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

  • 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
    プライマリ リターン コード。この動詞は、同時同期動詞の最大数を超えています。

注釈

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

ビット 説明
0 TIME_STAMP_SUBVECTOR。 日付/時刻サブベクトルをデータに追加します。 使用できる値には、SV_ADDとSV_NO_ADDが含まれます。
1 PRODUCT_SET_ID_SUBVECTOR。 サブベクトルProduct_Set_IDデータに追加します。 これにより、ネットワーク管理サービスはアラートの送信者を識別できます。 使用できる値には、SV_ADDとSV_NO_ADDが含まれます。
2 SSCP_PU_SESSION。 セッションがアクティブな場合は、診断用に構成された接続で SSCP-PU セッション上のデータを送信します。 (データは、セッションで送信されるか、SV_STATE_CHECKまたはSV_COMM_SUBSYSTEM_NOT_LOADEDが返されるかに関係なく、エラー ログに追加されます)。使用できる値には、SV_SENDとSV_NO_SENDが含まれます。
3 LOCAL_LOGGING。 エラー ログから取得され、ホストに転送されるローカル アラートをログに記録します。 このオプションは、 SV_NMVT data_type するか、オプション SV_SENDを 指定data_type SV_ALERT_SUBVECTORSが指定されている場合にのみ有効です。 使用できる値には、SV_LOGとSV_NO_LOGが含まれます。
4 から 7 予約済み