Freigeben über

TRANSFER_MS_DATA

Das TRANSFER_MS_DATA Verb erstellt eine SNA-Anforderungseinheit mit NMVT-Daten (Network Management Vector Transport). Das Verb kann die NMVT-Daten zur zentralen Problemdiagnose und -lösung an NetView senden. Die Daten werden in der lokalen Überwachungsdatei protokolliert.

In der folgenden Struktur wird der verbsteuerungsblock (VCB) beschrieben, der vom TRANSFER_MS_DATA Verb verwendet wird.

Syntax

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

Elemente

opcode
Angegebener Parameter. Das Verb, das den Vorgangscode identifiziert, SV_TRANSFER_MS_DATA.

data_type
Angegebener Parameter. Gibt den Typ der von diesem Verb bereitgestellten Daten an:

  • Verwenden Sie SV_NMVT, um einen NMVT zu generieren (einschließlich des NS-Headers, des Hauptnetzwerkverwaltungsvektors und untervectors).

  • Verwenden Sie SV_ALERT_SUBVECTORS, um ein RU zu generieren, das Daten für eine Warnung im entsprechenden Format enthält, ohne den NS-Header oder den Haupt-NMVT-Vektor.

  • Verwenden Sie SV_PDSTATS_SUBVECTORS, um ein RU zu generieren, das Daten für die Problemermittlungsstatistik im entsprechenden Format enthält, ohne den NS-Header oder den Haupt-NMVT-Vektor.

  • Verwenden Sie SV_USER_DEFINED, um benutzerdefinierte Daten zu generieren; Diese Daten werden im Fehlerprotokoll aufgezeichnet, können aber nicht an die Systemdienste Kontrollpunkt-physische Einheit (SSCP-PU) Sitzung der für die Diagnose konfigurierten Verbindung gesendet werden.

    reserv2
    Ein reserviertes Feld.

    primary_rc
    Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC am Ende des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

    secondary_rc
    Zurückgegebener Parameter. Gibt den von APPC festgelegten sekundären Rückgabecode am Ende des Verbs an. Die gültigen Rückgabecodes variieren je nach ausgegebenen APPC-Verb. Informationen zu gültigen Fehlercodes für dieses Verb finden Sie unter "Rückgabecodes".

    Optionen
    Angegebener Parameter. Gibt die gewünschten Optionen an, indem einzelne Bits ein- oder ausgeschaltet werden. (Bits 1, 2 und 3 werden ignoriert, wenn data_type auf SV_USER_DEFINED festgelegt ist.) Weitere Informationen finden Sie im Abschnitt "Hinweise".

    Reserv3
    Ein reserviertes Feld.

    origntr_id
    Angegebener Parameter. Gibt den Namen der Komponente an, die TRANSFER_MS_DATA ausgibt. Dieser Parameter ist optional. Legen Sie sie auf 0x00 fest, wenn das System es ignorieren soll.

    dlen
    Angegebener Parameter. Gibt die Länge der Daten an, die für dieses Verb bereitgestellt werden sollen. Die Gesamtlänge der Daten (vom Benutzer bereitgestellte Daten und alle hinzugefügten Header oder Untervektoren) müssen in ein RU passen. Die maximale RU-Länge beträgt 512 Byte.

    dptr
    Angegebener Parameter. Gibt die Adresse der zu sendenden Daten an.

Rückgabecodes

SV_OK
Primärer Rückgabecode; das Verb erfolgreich ausgeführt wurde.

SV_PARAMETER_CHECK
Primärer Rückgabecode; das Verb wurde aufgrund eines Parameterfehlers nicht ausgeführt.

SV_DATA_EXCEEDS_RU_SIZE

Sekundärer Rückgabecode; Die zu sendenden Daten waren zu lang. Die Länge der vom Benutzer bereitgestellten Daten plus Header und hinzugefügten Untervektoren muss in ein einzelnes RU passen, das nicht mehr als 512 Bytes lang ist.

SV_INVALID_DATA_SEGMENT

Sekundärer Rückgabecode; Der puffer, auf den dptr verweist, war kein lesbares Segment oder wurde über die Segmentgrenze hinaus erweitert.

SV_INVALID_DATA_TYPE

Sekundärer Rückgabecode; der data_type Parameter einen ungültigen Wert enthielt.

SV_STATE_CHECK
Primärer Rückgabecode; das Verb wurde nicht ausgeführt, weil es in einem ungültigen Zustand ausgegeben wurde.

SV_SSCP_PU_SESSION_NOT_ACTIVE

Sekundärer Rückgabecode; der NMVT nicht gesendet wurde; entweder die SSCP-PU Sitzung nicht aktiv war, der Knoten, der für den Empfang von Diagnoseinformationen konfiguriert wurde, war nicht aktiv, oder es wurde keine Netzwerkverwaltungsverbindung konfiguriert.

SV_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; Eine erforderliche Komponente konnte beim Verarbeiten des Verbs nicht geladen oder beendet werden. So konnte die Kommunikation nicht stattfinden. Wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

SV_INVALID_VERB
Primärer Rückgabecode; der Opcode-Parameter entspricht nicht dem Vorgangscode eines Verbs. Kein Verb ausgeführt.

SV_INVALID_VERB_SEGMENT
Primärer Rückgabecode; die VCB über das Ende des Datensegments hinaus erweitert wurde.

SV_UNEXPECTED_DOS_ERROR
Primärer Rückgabecode; eine der folgenden Bedingungen ist aufgetreten:

  • Fehler des Microsoft Windows-Betriebssystems beim Verarbeiten des Verbs. Der Rückgabecode des Betriebssystems wurde über den sekundären Rückgabecode zurückgegeben. Wenn das Problem weiterhin besteht, wenden Sie sich an den Systemadministrator, um Korrekturmaßnahmen zu ergreifen.

  • Eine CSV-Datei wurde aus einer Nachrichtenschleife ausgegeben, die von einer anderen Anwendung aufgerufen wurde, die einen Windows SendMessage-Funktionsaufruf ausgibt, anstatt den häufigeren Windows PostMessage-Funktionsaufruf . Die Verbverarbeitung kann nicht erfolgen.

  • Eine CSV wurde ausgegeben, als SendMessage Ihre Anwendung aufgerufen hat. Mithilfe des InSendMessage-Funktionsaufrufs der Windows-API können Sie ermitteln, ob Ihre Anwendung mit SendMessage aufgerufen wurde.

    SV_CANCELLED
    Primärer Rückgabecode; Dieser Code wird für ein asynchrones Verb zurückgegeben, wenn er von einem WinCSVCleanup-Aufruf heruntergefahren wurde.

    SV_SERVER_RESOURCE_NOT_FOUND
    Primärer Rückgabecode; Es wurde kein Kommunikationsserver gefunden, der die angeforderte Funktion bereitstellen konnte.

    SV_SERVER_RESOURCES_LOST
    Primärer Rückgabecode; Der Kommunikationsserver, der die Funktion bereitstellte, wurde aufgrund eines Verbindungsfehlers verloren.

    SV_SERVER_CONN_FAILURE

    Sekundärer Rückgabecode; Die Verbindung mit dem Server wurde aufgrund von physischen Pfadproblemen verloren; Beispielsweise wurde der Server möglicherweise ausgeschaltet.

    SV_THREAD_BLOCKING
    Primärer Rückgabecode; Dieses Verb überschreitet die maximale Anzahl gleichzeitig zulässiger synchroner Verben.

Bemerkungen

Um Optionen anzugeben, aktivieren oder deaktivieren Sie Bits wie folgt:

Bit BESCHREIBUNG
0 TIME_STAMP_SUBVECTOR. Fügt daten den Daten Datums-/Uhrzeit-Untervektor hinzu. Zulässige Werte sind SV_ADD und SV_NO_ADD.
1 PRODUCT_SET_ID_SUBVECTOR. Fügt Product_Set_ID Subvector zu Daten hinzu. Dadurch können Netzwerkverwaltungsdienste den Absender einer Warnung identifizieren. Zulässige Werte sind SV_ADD und SV_NO_ADD.
2 SSCP_PU_SESSION. Sendet die Daten in der sitzung SSCP-PU für die Diagnose konfigurierten Verbindung, wenn die Sitzung aktiv ist. (Die Daten werden dem Fehlerprotokoll hinzugefügt, unabhängig davon, ob sie in der Sitzung gesendet wird oder ob SV_STATE_CHECK oder SV_COMM_SUBSYSTEM_NOT_LOADED zurückgegeben wird.) Zulässige Werte sind SV_SEND und SV_NO_SEND.
3 LOCAL_LOGGING. Protokolliert lokale Warnungen, die aus dem Fehlerprotokoll abgerufen und an den Host weitergeleitet werden. Diese Option ist nur gültig, wenn data_type SV_NMVT oder data_type SV_ALERT_SUBVECTORS mit option SV_SEND angegeben wird. Zulässige Werte umfassen SV_LOG und SV_NO_LOG.
4 bis 7 Reserviert
  • Last updated on