Set_CPIC_Side_Information 호출(함수 이름 xcmssi)은 메모리의 측면 정보 항목을 추가하거나 대체합니다. CPI-C 쪽 정보 항목은 대화 특성 집합을 기호 정의 이름과 연결합니다. 이 호출은 동일한 기호화된 대상 이름을 가진 항목을 재정의합니다.
문법
CM_ENTRY Set_CPIC_Side_Information(
unsigned char FAR *key_lock,
SIDE_INFO FAR *side_info_entry,
CM_INT32 FAR *side_info_entry_length,
CM_INT32 FAR *return_code
);
매개 변수
key_lock
제공된 매개 변수입니다. 이 매개 변수는 무시됩니다.
side_info_entry
제공된 매개 변수입니다. 측면 정보 항목의 내용을 지정합니다. 다음 표에서는 측면 정보 항목의 형식을 정의하는 side_info_entry 구조체에 대해 설명합니다.
| 상쇄 | 설명 | 유형 | 길이 |
|---|---|---|---|
| 0 | sym_dest_name | 부호 없는 문자 | 8바이트 |
| 8 (여덟) | partner_LU_name | 부호 없는 문자 | 17바이트 |
| 이십오 (25) | 예약 | 부호 없는 문자 | 3바이트 |
| 28 | TP_name_type | signed long int | 32비트 |
| 32 | TP_name | 부호 없는 문자 | 64바이트 |
| 96 | mode_name | 부호 없는 문자 | 8바이트 |
| 104 | conversation_ security_type | signed long int | 32비트 |
| 108 | security_user_ID | 부호 없는 문자 | 8바이트 |
| 116 | security_password | 부호 없는 문자 | 8바이트 |
sym_dest_name 허용되는 문자는 대문자(A~Z) 및 0부터 9까지의 숫자입니다.
Set_CPIC_Side_Information SNA TP(서비스 트랜잭션 프로그램)를 파트너 프로그램으로 지정할 수 있는 유일한 CPI-C 호출입니다. 서비스 TP의 이름을 지정하는 SNA 규칙은 최대 4자입니다. 첫 번째 문자는 0x00 0x3F 사이의 16진수 바이트입니다. 나머지 문자는 ASCII에서 EBCDIC로 변환됩니다.
다른 필드에 허용되는 문자는 해당 Set_ 호출에 대한 설명을 참조하세요. 예를 들어 mode_name 필드에 대해서는 Set_Mode_Name 호출에 대한 설명을 참조하세요.
구조체의 각 필드는 왼쪽 맞춤이어야 합니다. 필요에 따라 오른쪽에 공백이 있는 필드를 파드합니다.
side_info_entry_length
제공된 매개 변수입니다.
side_info_entry 길이를 지정합니다. 항상 124입니다.
return_code
이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.
반환 코드
CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다.
CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; 다음 중 하나가 발생했습니다.
side_info_entry 구조체에 지정된 값이 잘못되었습니다.
side_info_entry 왼쪽 문자에 공백이 있습니다.
CM_PRODUCT_SPECIFIC_ERROR
기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.
상태 변경 내용
대화는 모든 상태에 있을 수 있습니다.
상태 변경은 없습니다.
비고
할당이 실행될 때까지 측면 정보(예: 존재하지 않는 LU(파트너 논리 단위) 지정)의 잘못된 문자열 매개 변수가 검색되지 않습니다. 할당 다음 호출에서 오류가 반환됩니다.