RECEIVE_LOG_DATA

Il verbo RECEIVE_LOG_DATA consente all'utente di registrarsi per ricevere i dati di log associati a un report di errore di Gestione funzioni in ingresso 7 (FMH7). Il verbo passa un buffer ad APPC e tutti i dati di log ricevuti vengono inseriti nel buffer. APPC continua a usare questo buffer come FMH7 successivi fino a quando non viene fornito con un altro (ovvero, fino a quando il programma di transazione (TP) non rilascia un altro RECEIVE_LOG_DATA specificando un buffer diverso o nessun buffer.

Si noti che il TP stesso è responsabile dell'allocazione e della liberazione del buffer. Dopo che il buffer è stato passato ad APPC, il tp deve emettere un altro RECEIVE_LOG_DATA specificando un nuovo buffer o un buffer di lunghezza zero oppure attendere il completamento della conversazione prima di liberare il buffer originale.

Quando viene ricevuto un FMH7, APPC copia qualsiasi flusso di dati generale del log degli errori associato nel buffer. Se non è presente alcuna variabile del log degli errori associata, il buffer viene azzerato. È consigliabile controllare il buffer ogni volta che un codice restituito da un verbo di ricezione indica che è stato ricevuto un errore.

La struttura seguente descrive il blocco di controllo verbo (VCB) utilizzato dal verbo RECEIVE_LOG_DATA .

Sintassi

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

Membri

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_B_RECEIVE_LOG_DATA.

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo, AP_BASIC_CONVERSATION.

reserv1
Campo riservato.

primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

tp_id
Parametro fornito. Identifica il tp locale. Il valore di questo parametro viene restituito da TP_STARTED nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.

conv_id
Parametro fornito. Fornisce l'identificatore della conversazione. Il valore di questo parametro viene restituito da ALLOCATE nella chiamata tp o da RECEIVE_ALLOCATE nel tp richiamato.

log_dlen
Parametro fornito. Specifica la lunghezza massima dei dati di log che appC può inserire nel buffer, ovvero la dimensione del buffer. L'intervallo è compreso tra 0 e 65535. Si noti che una lunghezza pari a zero indica che qualsiasi verbo RECEIVE_LOG_DATA precedente deve essere annullato.

log_dptr
Parametro fornito. Specifica l'indirizzo del buffer che appC userà per archiviare i dati di log.

Codici di ritorno

AP_OK
Codice restituito primario; verbo eseguito correttamente.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_BAD_CONV_ID

Codice restituito secondario; il valore di conv_id non corrisponde a un identificatore di conversazione assegnato da APPC.

AP_BAD_TP_ID

Codice restituito secondario; il valore di tp_id non corrisponde a un identificatore TP assegnato da APPC.