/* @tier medium @module cl @transform closing-online */ /* * cl_ol_0023.pgc - 마감 온라인 서비스 (CL_OL_0023) [tier=medium] * * 채번 조회 * ---------------------------------------------------------------------- * 요청 영업일(BIZDATE)에 대해 현재까지 마감처리완료(M)된 건수를 채번 * 소진수로 보고, 다음 부여 순번(=소진수+1)을 산출하여 응답한다. 원장을 * 변경하지 않는 read-only 조회이며, 응답의 다음순번은 배치/온라인 채번 * 발급의 힌트로 사용된다. * * 소진 현황의 근거로 접수(R)/정산완료(S) 건수도 함께 조회하여 잔여 * 발급 여력(가용 채번 = 상한 - 소진)을 계산한다. 상한(CAP)은 선택 입력 * 으로 받되 미지정 시 일 100만 건을 기본 상한으로 적용한다. 감사추적을 * 위해 선택 입력 REQID/CHANNEL 을 반영한다. */ #include #include #include "txcore.h" #include "txcore_dbio.h" #include "acq_util.h" #include "cl_core.h" EXEC SQL INCLUDE sqlca; #define CL_OL_0023_DEFAULT_CAP 1000000L TX_SERVICE(CL_OL_0023, ctx) { EXEC SQL BEGIN DECLARE SECTION; char h_biz_date[9]; char h_st_done[2]; long h_db_used; char h_max_key[16]; EXEC SQL END DECLARE SECTION; char bizdate[16]; char reqid[32]; char channel[16]; char nextseq[16]; char summary[TX_VAL_LEN]; long done_cnt, recv_cnt, settled_cnt; long next_no; long cap = 0; long avail, usage_rate; tx_log(TX_LOG_INFO, "[CL_OL_0023] 채번 조회 서비스 진입"); /* 1) 입력 수신 및 검증 */ if (tx_buf_get(ctx->in, "BIZDATE", bizdate, sizeof(bizdate)) != TX_OK) { tx_log(TX_LOG_ERROR, "[CL_OL_0023] BIZDATE 누락"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID); tx_return(ctx, TX_EINVAL, ctx->out); return; } if (tx_buf_get(ctx->in, "REQID", reqid, sizeof(reqid)) != TX_OK) strncpy(reqid, "-", sizeof(reqid) - 1); if (tx_buf_get(ctx->in, "CHANNEL", channel, sizeof(channel)) != TX_OK) strncpy(channel, "ON", sizeof(channel) - 1); if (!date_is_valid(bizdate)) { tx_log(TX_LOG_WARN, "[CL_OL_0023] 영업일 형식 오류 date=%s", bizdate); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_INVALID); tx_return(ctx, TX_EINVAL, ctx->out); return; } /* 채번 상한 보정 */ tx_buf_getlong(ctx->in, "CAP", &cap); if (cap <= 0) cap = CL_OL_0023_DEFAULT_CAP; /* 2) 상태별 건수 조회 (표준 DBIO, read-only) */ done_cnt = cl_rec_count(bizdate, CL_ST_DONE); recv_cnt = cl_rec_count(bizdate, CL_ST_RECV); settled_cnt = cl_rec_count(bizdate, CL_ST_SETTLED); if (done_cnt < 0 || recv_cnt < 0 || settled_cnt < 0) { tx_log(TX_LOG_ERROR, "[CL_OL_0023] 채번 소진수 조회 실패 date=%s", bizdate); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR); tx_return(ctx, TX_EDB, ctx->out); return; } /* * 3) 다음 순번 산출 및 채번 키 구성(YYYYMMDD + 6자리 일련) * - 소진수(done_cnt)는 이미 마감완료(M)로 확정된 건수이므로 * 다음 발급 순번은 소진수 + 1 이 된다. * - 가용 여력(avail)은 일 상한(cap)에서 소진수를 뺀 값이며 * 음수가 되지 않도록 0 하한으로 보정한다. */ /* * 2-1) 원장 직접 집계로 소진수(마감완료 M)를 재확인하고, 이미 발급된 * 최대 처리키를 조회하여 채번 연속성의 근거로 삼는다. */ strncpy(h_biz_date, bizdate, sizeof(h_biz_date) - 1); h_biz_date[sizeof(h_biz_date) - 1] = '\0'; strncpy(h_st_done, CL_ST_DONE, sizeof(h_st_done)); h_db_used = 0; h_max_key[0] = '\0'; EXEC SQL SELECT count(*), coalesce(max(key), '') INTO :h_db_used, :h_max_key FROM cl_ledger WHERE biz_date = :h_biz_date AND status = :h_st_done; if (sqlca.sqlcode != TX_SQL_OK && sqlca.sqlcode != TX_SQL_NOTFOUND) { TX_DBIO_LOG_ERR("CL_OL_0023 direct used"); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_SYSERR); tx_return(ctx, TX_EDB, ctx->out); return; } next_no = done_cnt + 1; avail = (cap > done_cnt) ? (cap - done_cnt) : 0; usage_rate = (cap > 0) ? (done_cnt * 100 / cap) : 0; snprintf(nextseq, sizeof(nextseq), "%.8s%06ld", bizdate, next_no); /* 4) 채번 현황 요약 문구 */ snprintf(summary, sizeof(summary), "영업일 %s 채번 소진 %ld / 상한 %ld (소진율 %ld%%), 다음순번 %ld", bizdate, done_cnt, cap, usage_rate, next_no); tx_buf_reset(ctx->out); tx_buf_sets(ctx->out, "RESPCODE", RESP_OK); tx_buf_sets(ctx->out, "BIZDATE", bizdate); tx_buf_sets(ctx->out, "REQID", reqid); tx_buf_sets(ctx->out, "CHANNEL", channel); tx_buf_setlong(ctx->out, "USEDCNT", done_cnt); tx_buf_setlong(ctx->out, "DBUSED", h_db_used); tx_buf_sets(ctx->out, "MAXKEY", h_max_key); tx_buf_setlong(ctx->out, "RECVCNT", recv_cnt); tx_buf_setlong(ctx->out, "SETTLEDCNT", settled_cnt); tx_buf_setlong(ctx->out, "CAP", cap); tx_buf_setlong(ctx->out, "AVAIL", avail); tx_buf_setlong(ctx->out, "USAGERATE", usage_rate); tx_buf_setlong(ctx->out, "NEXTNO", next_no); tx_buf_sets(ctx->out, "NEXTSEQ", nextseq); tx_buf_sets(ctx->out, "SUMMARY", summary); tx_buf_sets(ctx->out, "EXHAUSTED", (avail == 0) ? "Y" : "N"); /* 발급 여력 임계(잔여 상한의 10% 미만) 사전 경고 플래그 */ tx_buf_sets(ctx->out, "LOWALERT", (cap > 0 && avail * 10 < cap) ? "Y" : "N"); tx_log(TX_LOG_INFO, "[CL_OL_0023] 완료 date=%s 소진=%ld 다음순번=%ld 가용=%ld ch=%s", bizdate, done_cnt, next_no, avail, channel); tx_return(ctx, TX_OK, ctx->out); }