Set_Log_Data (CPI-C)

Artikel
07/21/2023

Der Set_Log_Data-Aufruf (Funktionsname cmsld) gibt eine Protokollmeldung (Protokolldaten) und deren Länge an, die an die Partner-Logische Einheit (LU) gesendet werden soll. Dieser Anruf ist nur in einfachen Unterhaltungen zulässig. Sie überschreibt die Standardprotokolldaten( NULL) und die Standardlänge der Protokolldaten( Null).

Syntax

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

Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation oder Accept_Conversation zurückgegeben.

log_data
Angegebener Parameter. Gibt die Startadresse der Daten an, die an die Partner-LU gesendet werden sollen. Er kann bis zu 512 ASCII-Zeichen enthalten. Zulässige Zeichen sind:

Groß- und Kleinbuchstaben.
Ziffern von 0 bis 9.
Sonderzeichen.
Der Platz.

log_data_length
Angegebener Parameter. Gibt die Länge der Protokolldaten an. Der Bereich reicht von 0 bis 512 Bytes.

Eine Länge von 0 gibt an, dass keine Protokolldaten vorhanden sind und der parameter log_data ignoriert wird.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; eine der folgenden Ereignisse:

Der von conversation_ID angegebene Wert ist ungültig.
Der Konversationstyp ist auf zugeordnet festgelegt.
Der von log_data_length angegebene Wert liegt außerhalb des Bereichs (größer als 512 oder kleiner als 0).

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand mit Ausnahme von RESET befinden.

Es gibt keine Zustandsänderung.

Hinweise

Die von Set_Log_Data angegebenen Protokolldaten werden an die Partner-LU gesendet, wenn das lokale Programm einen der folgenden Aufrufe ausgibt:

Send_Error
Aufheben der Zuordnung mit dem auf CM_DEALLOCATE_ABEND
Send_Data , wobei der Sendetyp "Unterhaltungen" auf "CM_SEND_AND_DEALLOCATE" und der Typ "Aufheben der Zuordnung" auf "CM_DEALLOCATE_ABEND

Nach dem Senden der Protokolldaten an die Partner-LU setzt die lokale LU die Protokolldaten auf NULL und die Protokolldatenlänge auf Null zurück.

CPI-C konvertiert die Protokolldaten nach Bedarf automatisch aus ASCII in andere Codierungsstandards, z. B. EBCDIC.

Freigeben über