Specify_Local_TP_Name(CPI-C)

지정된 이름으로 전달되는 들어오는 대화를 수락할 수 있음을 나타내기 위해 프로그램에서 Specify_Local_TP_Name 호출(함수 이름 cmsltp)을 실행합니다.

구문

  
CM_ENTRY Specify_Local_TP_Name(   
  unsigned char FAR *TP_name,    
  CM_INT32 FAR *TP_name_length,    
  CM_INT32 FAR *return_code    
);  

매개 변수

TP_name
제공된 매개 변수입니다. TP(로컬 트랜잭션 프로그램) 이름의 시작 주소를 지정합니다. 프로그램 이름은 최대 64개의 ASCII 문자를 포함할 수 있습니다. 허용되는 문자는 다음과 같습니다.

• 대문자 및 소문자입니다.

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

• 공백을 제외한 특수 문자입니다.

  Specify_Local_TP_Name 사용하여 SNA 서비스 TP의 이름을 지정할 수 없습니다.

  간지와 같은 더블 바이트 문자 집합은 지원되지 않습니다.

  TP_name_length
  제공된 매개 변수입니다. 로컬 프로그램 이름의 길이를 지정합니다. 범위는 1에서 64까지입니다.

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

반환 코드

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

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

• 제공된 TP_name 잘못되었습니다.

• TP_name_length 지정된 값이 범위를 벗어났습니다(64보다 크거나 1보다 작음).

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

상태 변경

호출은 특정 대화와 연결되지 않으며 상태 제한이 적용되지 않습니다.

상태 변경은 없습니다.

설명

프로그램에서 이 호출을 두 번 이상 실행하여 둘 이상의 TP 이름으로 들어오는 대화를 처리할 수 있습니다. 프로그램은 Extract_TP_Name 호출하여 들어오는 대화에서 실제 이름을 검색할 수 있습니다.