Set_Log_Data (CPI-C)

Articolo
07/21/2023

La chiamata Set_Log_Data (nome funzione cmsld) specifica un messaggio di log (dati di log) e la relativa lunghezza da inviare all'unità logica partner (LU). Questa chiamata è consentita solo nelle conversazioni di base. Esegue l'override dei dati di log predefiniti, ovvero Null, e la lunghezza dei dati di log predefinita, che è zero.

Sintassi

  
CM_ENTRY Set_Log_Data(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *log_data,           
  CM_INT32 FAR *log_data_length,         
  CM_INT32 FAR *return_code              
);

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.

log_data
Parametro fornito. Specifica l'indirizzo iniziale dei dati da inviare all'lu partner. Può contenere fino a 512 caratteri ASCII. I caratteri consentiti sono:

Lettere maiuscole e minuscole.
Numeri da 0 a 9.
Caratteri speciali.
Spazio.

log_data_length
Parametro fornito. Specifica la lunghezza dei dati di log. L'intervallo è compreso tra 0 e 512 byte.

Una lunghezza di 0 indica che non sono presenti dati di log e il parametro log_data viene ignorato.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

Il valore specificato da conversation_ID non è valido.
Il tipo di conversazione è impostato su mappato.
Il valore specificato da log_data_length non è compreso nell'intervallo (maggiore di 512 o minore di 0).

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione può essere in qualsiasi stato tranne RESET.

Non esiste alcuna modifica dello stato.

Commenti

I dati di log specificati da Set_Log_Data vengono inviati all'lu partner quando il programma locale genera una delle chiamate seguenti:

Send_Error
Deallocare con il tipo deallocate conversazioni impostato su CM_DEALLOCATE_ABEND
Send_Data con il tipo di invio conversazioni impostato su CM_SEND_AND_DEALLOCATE e il tipo deallocate impostato su CM_DEALLOCATE_ABEND

Dopo aver inviato i dati di log all'LU partner, l'lu locale reimposta i dati del log su Null e la lunghezza dei dati di log su zero.

CPI-C converte automaticamente i dati di log da ASCII ad altri standard di codifica, ad esempio EBCDIC, come richiesto.

Condividi tramite