Set_Mode_Name(CPI-C)

Set_Mode_Name 호출(함수 이름 cmsmn)은 호출 프로그램에서 실행되어 대화의 모드 이름을 지정합니다. 이 호출은 Initialize_Conversation 호출이 실행되었을 때 측면 정보에서 파생된 시스템 정의 모드 이름을 재정의합니다. 할당이 실행된 후에는 이 호출을 실행할 수 없습니다. 이 호출을 실행해도 측면 정보 자체에는 영향을 주지 않습니다.

구문

  
CM_ENTRY Set_Mode_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *mode_name,      
  CM_INT32 FAR *mode_name_length,    
  CM_INT32 FAR *return_code          
);  

매개 변수

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

mode_name
제공된 매개 변수입니다. 모드 이름의 시작 주소(구성 중에 정의된 네트워킹 특성 집합의 이름)를 지정합니다. 모드 이름은 최대 8개의 ASCII 문자를 포함할 수 있습니다. 허용되는 문자는 다음과 같습니다.

• 대문자

• 0에서 9까지의 숫자입니다.

  mode_name 값은 구성 중에 LU(파트너 논리 단위)와 연결된 모드의 이름과 일치해야 합니다. 모드 이름은 SNASVCMG 또는 CPSVCMG일 수 없습니다.

  mode_name_length
  제공된 매개 변수입니다. 모드 이름의 길이를 지정합니다. 범위는 0~8바이트입니다.

  mode_name_length 0으로 설정되면 Set_Mode_Name 무시됩니다.

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

반환 코드

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

CM_PROGRAM_STATE_CHECK
기본 반환 코드; 대화가 INITIALIZE 상태가 아닙니다.

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

• conversation_ID 지정한 값이 잘못되었습니다.

• mode_name_length 지정한 값이 범위를 벗어났습니다(8보다 크거나 0보다 작음).

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

상태 변경

대화는 INITIALIZE 상태여야 합니다.

상태 변경은 없습니다.

설명

할당이 실행될 때까지 mode_name 잘못된 값을 지정하는 것은 검색되지 않습니다.