Freigeben über

COPY_TRACE_TO_FILE

Das COPY_TRACE_TO_FILE Verb verkettet einzelne API/Link-Dienstablaufverfolgungsdateien, um eine einzelne Datei zu bilden.

In der folgenden Struktur wird der verbsteuerungsblock (VCB) beschrieben, der vom COPY_TRACE_TO_FILE 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];  
};

Elemente

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

Reserv3
Ein reserviertes Feld.

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

file_option
Angegebener Parameter. Gibt die Option zum Kopieren der 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, wenn 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 erfolgreich ausgeführt wurde.

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

SV_INVALID_FILE_OPTION
Sekundärer Rückgabecode; ein anderer Wert als SV_NEW oder SV_OVERWRITE wurde für file_option angegeben.

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

SV_COPY_TRACE_IN_PROGRESS
Sekundärer Rückgabecode; ein zuvor ausgestelltes COPY_TRACE_TO_FILE Verb ist noch in Bearbeitung.

SV_TRACE_FILE_EMPTY
Sekundärer Rückgabecode; es sind keine Daten in den Ablaufverfolgungsdateien vorhanden.

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

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_OUTPUT_DEVICE_FULL
Primärer Rückgabecode; auf dem Gerät, auf dem sich die Ausgabedatei befindet, 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:

  • Beim Verarbeiten des Verbs ist beim Verarbeiten 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 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.

Bemerkungen

Es gibt zwei API/Link-Service-Ablaufverfolgungsdateien. Die Dateien werden abwechselnd verwendet; Die Ablaufverfolgung wechselt von einer Datei zur anderen, wenn eine Datei voll ist (größer als 250K). 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/Link-Service-Ablaufverfolgung wird vor dem Ausgeben des Verbs beendet und nach Abschluss der Kopie neu gestartet. Die Ablaufverfolgungsdateien werden zurückgesetzt, wenn dieses Verb erfolgreich abgeschlossen wurde.

  • Last updated on