MC_RECEIVE_LOG_DATA

Il verbo MC_RECEIVE_LOG_DATA consente all'utente di registrare per ricevere i dati di log associati a un report di errore di gestione delle funzioni in ingresso 7 (FMH7). Il verbo passa un buffer a 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 buffer (ovvero, fino a quando il programma di transazione (TP) non genera un altro MC_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 aver passato il buffer all'APPC, il TP deve rilasciare un altro MC_RECEIVE_LOG_DATA specificando un nuovo buffer o un buffer a lunghezza zero oppure attendere fino al termine della conversazione prima di liberare il buffer originale.

Quando viene ricevuto un FMH7, APPC copia qualsiasi flusso di dati generale del log degli errori (GDS) associato nel buffer. Se non è presente alcuna variabile del log degli errori associata, il buffer è zero. È 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) usato dal verbo MC_RECEIVE_LOG_DATA verbo.

Sintassi

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

Members

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

opext
Parametro fornito. Specifica l'estensione dell'operazione verbo, AP_MAPPED_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 MC_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 le dimensioni del buffer. L'intervallo è compreso tra 0 e 65535. Si noti che una lunghezza di zero qui indica che è necessario annullare qualsiasi verbo MC_RECEIVE_LOG_DATA precedente.

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

Codici restituiti

AP_OK
Codice restituito primario; il 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.