pdcomm_gem_formatted_program_query_submit
함수
장비로 S7F25 Formatted Process Program Request를 보냅니다.
PdcommStatus pdcomm_gem_formatted_program_query_submit(PdcommTcpEndpoint *endpoint, const PdcommSecsItem *id, PdcommTcpToken *out_token)호스트 전용입니다. S7F25를 큐에 넣기 전에 PPID를 복사합니다. 성공은 요청이 송신용으로 접수되었다는 뜻입니다. S7F26 응답, T3 시간 초과(timeout), 연결 끊김은 나중에 반환된 토큰과 함께 pdcomm_gem_handle_event()로 보고됩니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | GEM COMMUNICATING 상태인 호스트 엔드포인트입니다. |
id | PPID: 최대 120바이트이며 비어 있지 않은 ASCII 또는 Binary 항목입니다. |
out_token | 트랜잭션 토큰을 받습니다. NULL이 아니면 항상 먼저 0으로 초기화되므로, 실패하면 항상 0입니다. |
반환값
S7F25를 큐에 넣었으면 #PDCOMM_OK를 반환합니다. endpoint, id 또는 out_token이 NULL이거나, id가 ASCII 또는 Binary 항목이 아니거나, PPID가 비어 있거나 120바이트보다 길면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 엔드포인트가 COMMUNICATING 상태의 호스트가 아니거나 서비스가 구성되지 않았으면 #PDCOMM_INVALID_STATE를 반환합니다. 이미 max_pending개의 요청이 대기 중이거나 메시지가 엔드포인트의 SECS-II 한도를 넘으면 #PDCOMM_LIMIT_EXCEEDED를 반환합니다. 준비된 TCP 이벤트(staged event)를 먼저 비워야 하거나, GEM 요청 슬롯 32개가 모두 사용 중이거나, TCP 송신 큐가 가득 차면 #PDCOMM_BACKPRESSURE를 반환합니다. 요청을 큐에 넣을 수 없으면 #PDCOMM_IO_ERROR 같은 그 밖의 TCP 상태 코드를 반환합니다. 엔드포인트가 오염(poisoned) 상태이면 #PDCOMM_POISONED를 반환합니다.
참고
- 스레드 안전성:
endpoint에 대한 다른 모든 호출과 직렬화합니다.