TP_STARTED 동사는 TP(호출 트랜잭션 프로그램)에서 실행되며, TP가 시작 중임을 APPC에 알깁니다.
Microsoft® Windows® 버전 3의 경우 x 시스템, 이 호출의 차단 버전 대신 WinAsyncAPPC 함수를 사용하는 것이 좋습니다.
다음 구조에서는 TP_STARTED 동사에서 사용하는 동사 제어 블록에 대해 설명합니다.
문법
struct tp_started {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char lu_alias[8];
unsigned char tp_id[8];
unsigned char tp_name[64];
unsigned char syncpoint_rqd;
};
구성원
opcode
제공된 매개 변수입니다. 동사 작업 코드 AP_TP_STARTED 지정합니다.
opext
제공된 매개 변수입니다. 동사 연산 확장을 지정합니다. AP_EXTD_VCB 비트가 설정되면 tp_started 구조에 동기화 지점 지원에 사용되는 syncpoint_rqd 멤버가 포함됨을 나타냅니다. 그렇지 않으면 동사 제어 블록이 tp_name 멤버 바로 후에 끝납니다.
reserv2
예약 필드입니다.
primary_rc
반환된 매개 변수입니다. 동사가 완료될 때 APPC에서 설정한 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발급된 APPC 동사에 따라 달라집니다. 이 동사에 대한 유효한 오류 코드는 반환 코드를 참조하세요.
secondary_rc
반환된 매개 변수입니다. 동사가 완료될 때 APPC에서 설정한 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발급된 APPC 동사에 따라 달라집니다. 이 동사에 대한 유효한 오류 코드는 반환 코드를 참조하세요.
lu_alias
제공된 매개 변수입니다. 로컬 LU가 로컬 TP에 알려진 별칭을 지정합니다.
이름은 구성 중에 설정된 LU 별칭과 일치해야 합니다. APPC는 현재 Host Integration Server 구성 파일에 대해 LU 별칭을 확인합니다. 그러나 Host Integration Server에서 사용하는 클라이언트/서버 아키텍처로 인해 이 매개 변수는 ALLOCATE 또는 MC_ALLOCATE 수행될 때까지 유효성이 검사되지 않습니다.
이 매개 변수는 8 바이트 ASCII 문자열입니다. 다음 ASCII 문자로 구성됩니다.
대문자
0에서 9까지의 숫자
공백
특수 문자 $, #, % 및 @
이 문자열의 첫 번째 문자는 공백일 수 없습니다.
이 매개 변수의 길이가 8바이트 미만이면 ASCII 공백(0x20)을 사용하여 오른쪽에 패딩합니다.
기본 LU 풀에서 LU를 사용하려면 이 필드를 86진수 0으로 설정합니다. 자세한 내용은 기본 RU를 참조하세요.
tp_id
반환된 매개 변수입니다. 새로 설정된 TP를 식별합니다.
tp_name
제공된 매개 변수입니다. 로컬 TP의 이름을 지정합니다.
APPC의 Host Integration Server 구현에서 이 매개 변수는 TP_STARTED 발급할 때 무시됩니다. 그러나 프로그램이 APPC의 OS/2 버전 1.0 구현에 대한 IBM ES에서 실행되는 경우 이 매개 변수가 필요합니다.
이 매개 변수는 64 바이트 EBCDIC 문자열이며 대/소문자를 구분합니다. tp_name 매개 변수는 다음 EDCDIC 문자로 구성될 수 있습니다.
대문자 및 소문자
0에서 9까지의 숫자
특수 문자 $, #, @, 마침표(.)
TP 이름이 길이가 64바이트 미만인 경우 EBCDIC 공백(0x40)을 사용하여 오른쪽에 패딩합니다.
서비스 TP 이름에 대한 SNA 규칙은 최대 4자입니다. 첫 번째 문자는 0x00 0x3F 사이의 16진수 바이트입니다.
syncpoint_rqd
이 선택적 매개 변수는 opext 매개 변수에 AP_EXTD_VCB 비트가 설정되고 동기화 지점 서비스가 필요한 경우에만 적용됩니다.
- 동기화 지점이 필요한지 AP_YES.
- 동기화 지점이 필요하지 않은 경우 AP_NO.
반환 코드
AP_OK
기본 반환 코드; 동사가 성공적으로 실행되었습니다.
AP_COMM_SUBSYSTEM_ABENDED
기본 반환 코드; 는 다음 조건 중 하나를 나타냅니다.
이 대화에 사용된 노드에 ABEND가 발견되었습니다.
TP와 PU 2.1 노드 간의 연결이 끊어졌습니다(LAN 오류).
TP 컴퓨터의 SnaBase에서 ABEND가 발견되었습니다.
시스템 관리자는 오류 로그를 검사하여 ABEND의 이유를 확인해야 합니다.
AP_COMM_SUBSYSTEM_NOT_LOADED
기본 반환 코드; 동사를 처리하는 동안 필요한 구성 요소를 로드하거나 종료할 수 없습니다. 따라서 통신을 할 수 없습니다. 정정 작업은 시스템 관리자에게 문의하세요.
AP_INVALID_VERB_SEGMENT
기본 반환 코드; VCB는 데이터 세그먼트의 끝을 넘어 확장되었습니다.
AP_STACK_TOO_SMALL
기본 반환 코드; 애플리케이션의 스택 크기가 너무 작아서 동사를 실행할 수 없습니다. 애플리케이션의 스택 크기를 늘입니다.
AP_TP_BUSY
기본 반환 코드; APPC가 동일한 TP에 대한 다른 호출을 처리하는 동안 로컬 TP가 APPC에 대한 호출을 실행했습니다.
AP_THREAD_BLOCKING
기본 반환 코드; 호출 스레드가 이미 차단 호출에 있습니다.
AP_UNEXPECTED_DOS_ERROR
기본 반환 코드; 운영 체제가 로컬 TP에서 APPC 호출을 처리하는 동안 APPC에 오류를 반환했습니다. 운영 체제 반환 코드는 secondary_rc 통해 반환됩니다. Intel 바이트 교환 순서로 표시됩니다. 문제가 지속되면 시스템 관리자에게 문의하세요.
비고
TP_STARTED 대한 응답으로 APPC는 호출 TP에 대한 TP 식별자를 생성합니다. 이 식별자는 호출 TP에서 발급한 후속 APPC 동사에 필요한 매개 변수입니다.
호출 TP에서 발급한 첫 번째 APPC 동사여야 합니다. 따라서 이전 APPC 상태가 없습니다.
동사가 성공적으로 실행되면(primary_rc AP_OK) 상태가 RESET로 변경됩니다.