Set_Log_Data(CPI-C)

아티클
07/21/2023

Set_Log_Data 호출(함수 이름 cmsld)은 로그 메시지(로그 데이터)와 LU(파트너 논리 단위)로 보낼 길이를 지정합니다. 이 호출은 기본 대화에서만 허용됩니다. null인 기본 로그 데이터와 기본 로그 데이터 길이(0)를 재정의합니다.

구문

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

매개 변수

conversation_ID
제공된 매개 변수입니다. 대화의 식별자를 지정합니다. 이 매개 변수의 값은 Initialize_Conversation 또는 Accept_Conversation 반환되었습니다.

log_data
제공된 매개 변수입니다. 파트너 LU로 보낼 데이터의 시작 주소를 지정합니다. 최대 512개의 ASCII 문자를 포함할 수 있습니다. 허용되는 문자는 다음과 같습니다.

대문자 및 소문자입니다.
0에서 9까지의 숫자입니다.
특수 문자.
공간입니다.

log_data_length
제공된 매개 변수입니다. 로그 데이터의 길이를 지정합니다. 범위는 0에서 512바이트까지입니다.

길이가 0이면 로그 데이터가 없고 log_data 매개 변수가 무시됩니다.

return_code
이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.

반환 코드

CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다.

CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; 다음 중 하나가 발생했습니다.

conversation_ID 지정한 값이 잘못되었습니다.
대화 유형이 매핑되도록 설정됩니다.
log_data_length 지정된 값이 범위를 벗어났습니다(512보다 크거나 0보다 작음).

CM_PRODUCT_SPECIFIC_ERROR
기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.

상태 변경

대화는 RESET을 제외한 모든 상태에 있을 수 있습니다.

상태 변경은 없습니다.

설명

로컬 프로그램에서 다음 호출 중 하나를 실행하면 Set_Log_Data 지정된 로그 데이터가 파트너 LU로 전송됩니다.

Send_Error
대화 할당 취소 형식을 CM_DEALLOCATE_ABEND
대화 보내기 유형이 CM_SEND_AND_DEALLOCATE 설정되고 할당 취소 형식이 CM_DEALLOCATE_ABEND 설정된 Send_Data

파트너 LU에 로그 데이터를 보낸 후 로컬 LU는 로그 데이터를 null로 다시 설정하고 로그 데이터 길이를 0으로 다시 설정합니다.

CPI-C는 필요에 따라 로그 데이터를 ASCII에서 EBCDIC와 같은 다른 인코딩 표준으로 자동으로 변환합니다.