Freigeben über

TRANSFER_MS_DATA

  • Artikel

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

Die folgende Struktur beschreibt den verb control block (VCB), 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;  
};

Member

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

data_type
Angegebener Parameter. Gibt den Datentyp an, der von diesem Verb bereitgestellt wird:

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

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

  • Verwenden Sie SV_PDSTATS_SUBVECTORS, um eine RU zu generieren, die Daten für Die Problemermittlungsstatistiken im entsprechenden Format ohne den NS-Header oder den haupt-NMVT-Vektor enthält.

  • Verwenden Sie SV_USER_DEFINED, um benutzerdefinierte Daten zu generieren. Diese Daten werden im Fehlerprotokoll aufgezeichnet, können aber nicht in der SSCP-PU-Sitzung (Systems Services Control Point Physical Unit) für die für Diagnose konfigurierte Verbindung gesendet werden.

    reserv2
    Ein reserviertes Feld.

    primary_rc
    Zurückgegebener Parameter. Gibt den primären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.

    secondary_rc
    Zurückgegebener Parameter. Gibt den sekundären Rückgabecode an, der von APPC nach Abschluss des Verbs festgelegt wird. Die gültigen Rückgabecodes variieren je nach ausgegebenem APPC-Verb. Gültige Fehlercodes für dieses Verb finden Sie unter „Rückgabecodes“.

    options
    Angegebener Parameter. Gibt die gewünschten Optionen an, indem einzelne Bits aktiviert oder deaktiviert 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 sie vom System ignoriert werden 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 Subvektoren) muss in eine RU passen. Die maximale RU-Länge beträgt 512 Bytes.

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

Rückgabecodes

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

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 Headern und hinzugefügten Subvektoren muss in ein einzelnes RU passen, das nicht mehr als 512 Byte 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 parameter data_type enthielt einen ungültigen Wert.

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

SV_SSCP_PU_SESSION_NOT_ACTIVE

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

SV_COMM_SUBSYSTEM_NOT_LOADED
Primärer Rückgabecode; eine erforderliche Komponente konnte während der Verarbeitung des Verbs nicht geladen oder beendet werden. Folglich 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 stimmte nicht mit dem Vorgangscode eines Verbs überein. Kein Verb ausgeführt.

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

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

  • Beim Microsoft Windows-Betriebssystem ist bei der Verarbeitung des Verbs ein Fehler aufgetreten. 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 von einer Nachrichtenschleife ausgegeben, die von einer anderen Anwendung aufgerufen wurde, welche einen Windows-SendMessage-Funktionsaufruf statt des häufigeren Windows-PostMessage-Funktionsaufrufs ausgegeben hat. Die Verbverarbeitung kann nicht durchgeführt werden.

  • Eine CSV-Datei wurde ausgegeben, als Ihre Anwendung von SendMessage aufgerufen wurde. Sie können ermitteln, ob der Aufruf Ihrer Anwendung mit SendMessage durch Verwendung des Windows-API-Funktionsaufrufs InSendMessage erfolgt ist.

    SV_CANCELLED
    Primärer Rückgabecode; Dieser Code wird für ein asynchrones Verb zurückgegeben, wenn es durch einen 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, ging aufgrund eines Verbindungsfehlers verloren.

    SV_SERVER_CONN_FAILURE

    Sekundärer Rückgabecode; Die Verbindung mit dem Server wurde aufgrund von Physischen Pfadproblemen unterbrochen; beispielsweise wurde der Server möglicherweise ausgeschaltet.

    SV_THREAD_BLOCKING
    Primärer Rückgabecode; Dieses Verb überschreitet die maximal zulässige Anzahl gleichzeitiger synchroner Verben.

Hinweise

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

bit BESCHREIBUNG
0 TIME_STAMP_SUBVECTOR. Fügt Datum/Uhrzeit-Subvektoren zu Daten hinzu. Zulässige Werte sind SV_ADD und SV_NO_ADD.
1 PRODUCT_SET_ID_SUBVECTOR. Fügt daten Product_Set_ID Subvektor 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 SSCP-PU-Sitzung über die für Diagnose konfigurierte Verbindung, wenn die Sitzung aktiv ist. (Die Daten werden dem Fehlerprotokoll hinzugefügt, unabhängig davon, ob sie in der Sitzung gesendet werden 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 der Option SV_SEND angegeben ist. Zulässige Werte sind SV_LOG und SV_NO_LOG.
4 bis 7 Reserviert