RECEIVE_LOG_DATA

Mit dem verb RECEIVE_LOG_DATA kann sich der Benutzer registrieren, um die Protokolldaten zu erhalten, die einem Fehlerbericht über eingehende Funktionsverwaltungsheader 7 (FMH7) zugeordnet sind. Das Verb übergibt einen Puffer an APPC, und alle empfangenen Protokolldaten werden in diesen Puffer eingefügt. APPC verwendet diesen Puffer weiterhin als aufeinander folgende FMH7s, bis er mit einem anderen bereitgestellt wird (d. h., bis das Transaktionsprogramm (TP) einen anderen RECEIVE_LOG_DATA einen anderen Puffer angibt oder überhaupt keinen Puffer angibt.

Beachten Sie, dass der TP selbst für das Zuweisen und Freigeben des Puffers verantwortlich ist. Nachdem der Puffer an APPC übergeben wurde, sollte der TP entweder einen anderen RECEIVE_LOG_DATA ausgeben , der einen neuen Puffer oder einen Puffer der Länge Null angibt, oder warten Sie, bis die Unterhaltung abgeschlossen ist, bevor Sie den ursprünglichen Puffer freigeben.

Wenn ein FMH7 empfangen wird, kopiert APPC alle zugeordneten Fehlerprotokolldatenströme (GENERAL Data Stream, GDS) in den Puffer. Wenn keine zugeordnete Fehlerprotokollvariable vorhanden ist, wird der Puffer aus null herausgezahlt. Es liegt bei der TP, den Puffer zu überprüfen, wenn ein Rückgabecode von einem Empfangsverb angibt, dass ein Fehler empfangen wurde.

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

Syntax

  
struct receive_log_data {  
    unsigned short      opcode;  
    unsigned char       opext;  
    unsigned char       reserv1;  
    unsigned short      primary_rc;  
    unsigned long       secondary_rc;  
    unsigned char       tp_id[8];  
    unsigned long       conv_id;  
    unsigned short      log_dlen;  
    unsigned char FAR * log_dptr;  
};   

Elemente

opcode
Angegebener Parameter. Gibt den Verbvorgangscode AP_B_RECEIVE_LOG_DATA an.

opext
Angegebener Parameter. Gibt die Verbvorgangserweiterung AP_BASIC_CONVERSATION an.

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

tp_id
Angegebener Parameter. Identifiziert das lokale TP. Der Wert dieses Parameters wird von TP_STARTED im aufrufenden TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

conv_id
Angegebener Parameter. Stellt den Unterhaltungsbezeichner bereit. Der Wert dieses Parameters wird von ALLOCATE im aufgerufenen TP oder von RECEIVE_ALLOCATE im aufgerufenen TP zurückgegeben.

log_dlen
Angegebener Parameter. Gibt die maximale Länge von Protokolldaten an, die APPC im Puffer platzieren kann (d. a. die Puffergröße). Der Bereich liegt zwischen 0 und 65535. Beachten Sie, dass hier eine Länge von Null angibt, dass alle vorherigen RECEIVE_LOG_DATA Verb abgebrochen werden sollen.

log_dptr
Angegebener Parameter. Gibt die Adresse des Puffers an, den APPC zum Speichern der Protokolldaten verwendet.

Rückgabecodes

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

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

AP_BAD_CONV_ID

Sekundärer Rückgabecode; der Wert von conv_id nicht mit einem Unterhaltungsbezeichner übereinstimmt, der von APPC zugewiesen wurde.

AP_BAD_TP_ID

Sekundärer Rückgabecode; der Wert von tp_id nicht mit einem TP-Bezeichner übereinstimmt, der von APPC zugewiesen wurde.