Freigeben über

COPY_TRACE_TO_FILE

  • Artikel

Das COPY_TRACE_TO_FILE-Verb verkettet einzelne API-/Linkdienst-Ablaufverfolgungsdateien zu einer einzelnen Datei.

In der folgenden Struktur wird der Verbkontrollblock (Verb Control Block, VCB) beschrieben, der vom DEFINE_TRACE-Verb verwendet wird.

Syntax


struct copy_trace_to_file {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        file_name[64];  
    unsigned char        file_option;  
    unsigned char        reserv4[12];  
};

Member

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

opext
Ein reserviertes Feld.

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“.

reserv3
Ein reserviertes Feld.

file_name
Angegebener Parameter. Gibt den Namen der Datei an, in die Ablaufverfolgungsdaten kopiert werden sollen. Dieser Parameter ist eine Zeichenfolge mit 64 Byte und kann einen Pfad enthalten. Wenn der Name weniger als 64 Bytes umfasst, verwenden Sie Leerzeichen, um ihn auf der rechten Seite aufzufüllen.

file_option
Angegebener Parameter. Gibt die Kopieroption für die Ausgabedatei an:

  • Verwenden Sie SV_NEW, um die Ablaufverfolgung nur zu kopieren, wenn die angegebene Datei noch nicht vorhanden ist.

  • Verwenden Sie SV_OVERWRITE, um die Ablaufverfolgung in eine vorhandene Datei zu kopieren und die aktuellen Daten zu überschreiben. Die Größe der Datei wird bei Bedarf erhöht. und die Datei wird erstellt, sofern sie noch nicht vorhanden ist.

reserv4
Die Adresse, an der sich die angegebenen Daten befinden.

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_INVALID_FILE_OPTION
Sekundärer Rückgabecode; für file_option wurde ein anderer Wert als SV_NEW oder SV_OVERWRITE angegeben.

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

SV_COPY_TRACE_IN_PROGRESS
Sekundärer Rückgabecode; ein zuvor ausgegebenes COPY_TRACE_TO_FILE-Verb wird noch ausgeführt.

SV_TRACE_FILE_EMPTY
Sekundärer Rückgabecode; die Ablaufverfolgungsdateien enthalten keine Daten.

SV_TRACE_NOT_STOPPED
Sekundärer Rückgabecode; eine Ablaufverfolgung wurde ausgeführt, als das Verb ausgegeben wurde.

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_FILE_ALREADY_EXISTS
Primärer Rückgabecode; wenn die Dateioption SV_NEW verwendet wurde, war der angegebene Dateiname der Name einer vorhandenen Datei.

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_OUTPUT_DEVICE_FULL
Primärer Rückgabecode; auf dem Gerät, auf dem sich die Ausgabedatei befindet, ist nicht genügend Speicherplatz vorhanden. Wiederholen Sie den Vorgang, nachdem Sie zusätzlichen Speicherplatz freigegeben haben.

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

  • Das Microsoft Windows-System hat beim Verarbeiten des Verbs einen Fehler festgestellt. 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.

Hinweise

Es gibt zwei API-/Linkdienst-Ablaufverfolgungsdateien. Die Dateien werden alternativ verwendet. Die Ablaufverfolgung wechselt von einer Datei zur anderen, wenn eine Datei voll ist (größer als 250.000). Wenn COPY_TRACE_TO_FILE aufgerufen wird, werden diese Ablaufverfolgungsdateien verkettet und in eine einzelne Datei kopiert, deren Name als Parameter für den Aufruf angegeben wird.

Die API-/Linkdienstablaufverfolgung wird beendet, bevor das Verb ausgegeben wird, und nach Abschluss der Kopie neu gestartet. Die Ablaufverfolgungsdateien werden zurückgesetzt, wenn dieses Verb erfolgreich abgeschlossen wurde.