/* @tier easy @module lg @transform ledger-online */ /* * lg_ol_0024.pgc - 원장 온라인 서비스 (LG_OL_0024) [tier=easy] * * 미결 완료전이: 단건 key 의 접수(R) 전표를 처리완료(M) 로 전이한다. * 이미 완료/정산 상태이면 전이하지 않고 경고 응답한다. */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "lg_core.h" EXEC SQL INCLUDE sqlca; /* * [업무 개요] * 접수(R) 상태로 대기 중인 미결 전표 한 건을 처리완료(M) 로 전이한다. * 전표가 이미 완료/정산 등 다른 상태이면 전이하지 않고 경고(WARN) 만 * 덧붙여 정상 응답한다. (멱등적 재시도 허용) * * [상태 전이] * R(접수) → M(처리완료) 이미 R 이 아니면 전이 없음 + WARN=ALREADY_DONE * * [동시성] * 조건부 UPDATE(WHERE status='R') 로 이중 처리 경합을 방지한다. 실제 전이 * 여부는 sqlca.sqlerrd[2](affected rows) 로 판정한다. * * [처리 절차] * 1) KEY 추출/검증. * 2) 현재 status 조회(없으면 RESP_NOMERCH). * 3) R 이 아니면 경고 응답(정상 종료). * 4) tx_begin 후 R→M 조건부 UPDATE, tx_commit. * * [응답 필드] * RESPCODE 처리결과코드 KEY 처리키(에코) * STATUS 전이후 상태 MOVED 실제 전이 건수(0/1) WARN 경고사유(옵션) */ TX_SERVICE(LG_OL_0024, ctx) { EXEC SQL BEGIN DECLARE SECTION; char h_key[16]; char h_status_r[2]; char h_status_m[2]; char h_cur_status[2]; EXEC SQL END DECLARE SECTION; char key[16]; long affected; tx_log(TX_LOG_INFO, "[LG_OL_0024] 미결 완료전이 진입"); if (tx_buf_get(ctx->in, "KEY", key, sizeof(key)) != TX_OK || key[0] == '\0') { tx_log(TX_LOG_ERROR, "[LG_OL_0024] KEY 누락"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID); tx_return(ctx, TX_EINVAL, ctx->out); return; } strncpy(h_key, key, sizeof(h_key) - 1); h_key[sizeof(h_key) - 1] = '\0'; strncpy(h_status_r, LG_ST_RECV, sizeof(h_status_r) - 1); h_status_r[sizeof(h_status_r) - 1] = '\0'; strncpy(h_status_m, LG_ST_DONE, sizeof(h_status_m) - 1); h_status_m[sizeof(h_status_m) - 1] = '\0'; /* 현재 상태 확인 (경고 판단용) */ EXEC SQL SELECT status INTO :h_cur_status FROM lg_ledger WHERE key = :h_key; if (sqlca.sqlcode == TX_SQL_NOTFOUND) { tx_log(TX_LOG_WARN, "[LG_OL_0024] 전표 없음 key=%s", key); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_NOMERCH); tx_return(ctx, TX_ENOENT, ctx->out); return; } if (sqlca.sqlcode != TX_SQL_OK) { TX_DBIO_LOG_ERR("lg_ol_0024 select"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR); tx_return(ctx, TX_EDB, ctx->out); return; } if (h_cur_status[0] != LG_ST_RECV[0]) { tx_log(TX_LOG_WARN, "[LG_OL_0024] 이미 처리됨 key=%s status=%s", key, h_cur_status); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_OK); tx_buf_sets(ctx->out, "KEY", key); tx_buf_sets(ctx->out, "STATUS", h_cur_status); tx_buf_sets(ctx->out, "WARN", "ALREADY_DONE"); tx_return(ctx, TX_OK, ctx->out); return; } if (tx_begin() != TX_OK) { tx_return(ctx, TX_FAIL, ctx->out); return; } /* R 상태 조건부 전이 (동시성 안전) */ EXEC SQL UPDATE lg_ledger SET status = :h_status_m, upd_ts = now() WHERE key = :h_key AND status = :h_status_r; if (sqlca.sqlcode != TX_SQL_OK) { TX_DBIO_LOG_ERR("lg_ol_0024 update"); tx_abort(); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR); tx_return(ctx, TX_EDB, ctx->out); return; } affected = (long)sqlca.sqlerrd[2]; if (tx_commit() != TX_OK) { tx_abort(); tx_return(ctx, TX_FAIL, ctx->out); return; } tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_OK); tx_buf_sets(ctx->out, "KEY", key); tx_buf_sets(ctx->out, "STATUS", (affected > 0) ? LG_ST_DONE : LG_ST_RECV); tx_buf_setlong(ctx->out, "MOVED", affected); tx_log(TX_LOG_INFO, "[LG_OL_0024] 완료전이 key=%s 반영=%ld", key, affected); tx_return(ctx, TX_OK, ctx->out); }