Set_Log_Data (CPI-C)

Der Set_Log_Data Aufruf (Funktionsname cmsld) gibt eine Protokollnachricht (Protokolldaten) und die Länge an, die an die logische Partnereinheit (LU) gesendet werden soll. Dieser Anruf ist nur in einfachen Unterhaltungen zulässig. Es überschreibt die Standardprotokolldaten, die null sind, und die Standardlänge der Protokolldaten, die Null ist.

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

Die 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. Sie kann bis zu 512 ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

• Groß- und Kleinbuchstaben.

• Ziffern von 0 bis 9.

• Sonderzeichen.

• Der Abstand.

  log_data_length
  Angegebener Parameter. Gibt die Länge der Protokolldaten an. Der Bereich liegt zwischen 0 und 512 Bytes.

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

  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; einer der folgenden Ereignisse:

• Der durch conversation_ID angegebene Wert ist ungültig.

• Der Unterhaltungstyp ist auf die Zuordnung festgelegt.

• Der durch 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 Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

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

Es gibt keine Zustandsänderung.

Bemerkungen

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

• Send_Error

• Deallocate with the conversations deallocate type set to CM_DEALLOCATE_ABEND

• Send_Data , wobei der Typ "Unterhaltungen senden" auf CM_SEND_AND_DEALLOCATE festgelegt ist und der "Deallocate"-Typ 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 von ASCII automatisch nach Bedarf in andere Codierungsstandards, z. B. EBCDIC.