# Business Logic — JKKNsidPwdChgOrsjgsCC.chkKnrn() [190 LOC]

| Field | Value |
|-------|-------|
| Fully Qualified Name | `com.fujitsu.futurity.bp.custom.common.JKKNsidPwdChgOrsjgsCC` |
| Layer | CC / Common Component (Customer-specific common business component) |
| Module | `common` (Package: `com.fujitsu.futurity.bp.custom.common`) |

## 1. Role

### JKKNsidPwdChgOrsjgsCC.chkKnrn()

This method performs **related entity validation** for the ISP Authentication ID and Password Change workflow targeting wholesale distributor operators (卸先事業者, "sensaki jigyousha") within the K-Opticom telecom customer management system. It acts as a **gatekeeper validation** — ensuring the wholesale distributor requesting the password change has a valid, active service contract, is operating within their application approval period, and that the authentication ID being changed genuinely belongs to the contracted service line.

The method implements a **sequential conditional check pattern** (sometimes called a guard-clause cascade): four independent validation phases execute in series, each short-circuiting on failure with a specific return code. If all four phases pass, the method returns `true`, allowing the calling `chgNsidPwd()` method to proceed with the actual password change. If any phase fails, the method returns `false` with a descriptive error code and message.

The four validation phases are:
1. **Contract Existence Check** — Verifies that a service contract exists for the given common key.
2. **Wholesaler Operator Check** — Verifies the wholesaler code in the customer agreement matches the originating channel, and confirms the wholesaler is within their active application period.
3. **Contract Status Check** — Verifies the service contract status is one of the accepted states (completed, in-process, paused, or suspended).
4. **Authentication ID Existence Check** — Verifies the authentication ID exists in the system and matches the one associated with the service contract.

The method is a **private shared utility** called exclusively by `chgNsidPwd()` (the main password change method) in `JKKNsidPwdChgOrsjgsCC`. It operates at the **CC (Common Component) layer**, sitting above CBS (Co-business System) service calls and below the screen-level business method.

## 2. Processing Pattern (Detailed Business Logic)

```mermaid
flowchart TD
    START(["chkKnrn params"])
    START --> EXTRACT["Extract from ccMsg: channel, commonKey, authenticationId"]
    EXTRACT --> OPE_DATE["Set opeDate = JPCBPCommon.getOpeDate(null)"]
    OPE_DATE --> INIT_RET["Initialize returnCode and returnMessage to empty strings"]
    INIT_RET --> CONTRACT_SVC["Call EKK0081A010CBS: Service Contract Inquiry"]
    CONTRACT_SVC --> CONTRACT_EXISTS{Contract exists?}
    CONTRACT_EXISTS -->|Yes| EXTRACT_CONTRACT["Extract svcKeiStat, sysid, updDtm from list[0]"]
    CONTRACT_EXISTS -->|No| ERROR_CONTRACT["Set returnCode=RETURN_CD_1100 Contract not found error"]
    EXTRACT_CONTRACT --> WHOLESALE_CHECK
    ERROR_CONTRACT --> EARLY_RETURN["Set response with error Return false"]
    WHOLESALE_CHECK["Call ECK0011A010CBS: Customer Inquiry"]
    WHOLESALE_CHECK --> WHOLESALE_EXISTS{Wholesaler found?}
    WHOLESALE_EXISTS -->|Yes| EXTRACT_ORSJGS["Extract orsjgsCd"]
    WHOLESALE_EXISTS -->|No| ERROR_CONTRACT
    EXTRACT_ORSJGS --> CHANNEL_MATCH{Channel equals orsjgsCd?}
    CHANNEL_MATCH -->|Yes| WHOLESALE_APPLY["Call ECH0911A010CBS: Wholesaler Application Inquiry"]
    CHANNEL_MATCH -->|No| ERROR_WHOLESALE["Set returnCode=RETURN_CD_1101 Wholesaler mismatch error"]
    WHOLESALE_APPLY --> APPLY_EXISTS{Application found?}
    APPLY_EXISTS -->|Yes| PERIOD_CHECK{opeDate between
orsjgsTstaymd and orsjgsTendymd?}
    APPLY_EXISTS -->|No| ERROR_CONTRACT
    PERIOD_CHECK -->|Yes| STATUS_CHECK
    PERIOD_CHECK -->|No| ERROR_WHOLESALE
    STATUS_CHECK["Contract Status Check"]
    STATUS_CHECK --> STATUS_OK{svcKeiStat in
valid status set?}
    STATUS_CHECK -->|No| STATUS_NOT_OK["Set returnCode=RETURN_CD_1102 Invalid contract status error"]
    STATUS_OK -->|Yes| AUTH_CHECK["Call EKK0171B001CBS: Auth ID List Inquiry"]
    STATUS_NOT_OK --> EARLY_RETURN
    AUTH_CHECK --> AUTH_EXISTS{Auth records found?}
    AUTH_EXISTS -->|Yes| EXTRACT_LAST["Extract ninshoId, ninshoIdPwd from last record"]
    AUTH_EXISTS -->|No| ERROR_AUTH["Set returnCode=RETURN_CD_1103 Auth ID missing error"]
    EXTRACT_LAST --> AUTH_ID_NOT_NULL{ninshoId not null?}
    AUTH_ID_NOT_NULL -->|No| ERROR_AUTH
    AUTH_ID_NOT_NULL -->|Yes| AUTH_ID_MATCH{authenticationId equals ninshoId?}
    AUTH_ID_MATCH -->|No| ERROR_AUTH
    AUTH_ID_MATCH -->|Yes| ALL_OK["Return true"]
    ALL_OK(["chkKnrn returns true"])
```

**Processing Flow Summary:**

1. **Initialization**: Extract `channel` (wholesaler origin), `commonKey` (service contract number), and `authenticationId` from the `ccMsg` map. Fetch the current operation date (`opeDate`) and initialize `returnCode`/`returnMessage` to empty strings.

2. **Phase 1 — Contract Existence Check**: Call CBS `EKK0081A010` (Service Contract Inquiry) with the common key and operation date. If no contract is found, return error code `1100`. Otherwise, extract the service contract status (`svcKeiStat`), system ID (`sysid`), and last update datetime (`updDtm`).

3. **Phase 2 — Wholesaler Operator Check** (conditional on Phase 1 passing):
   - Call CBS `ECK0011A010` (Customer Inquiry) using the `sysid`.
   - Extract the wholesaler code (`orsjgsCd`) and compare with the `channel`. If they differ, return error code `1101`.
   - If they match, call CBS `ECH0911A010` (Wholesaler Application Inquiry) with the channel to verify the wholesaler is within their active application period (between `orsjgsTstaymd` and `orsjgsTendymd`). If outside the period, return error code `1101`.

4. **Phase 3 — Contract Status Check** (conditional on Phase 2 passing): Verify `svcKeiStat` is one of the accepted status values: `020` (Completed), `CNC_ZM` (Connection Pending), `SVCTK_CHU` (Service Provisioning in Progress), `STAT_PAUSE` (Paused), or `STAT_STP` (Suspended). If not, return error code `1102`.

5. **Phase 4 — Authentication ID Existence Check** (conditional on Phase 3 passing): Call CBS `EKK0171B001` (Authentication ID List Inquiry) for the common key. If no records found, return error code `1103`. If records exist, extract the authentication ID and password from the last record (assumed single line). Validate that `ninshoId` is not null and matches the provided `authenticationId`. If either check fails, return error code `1103`.

6. **Result**: If no errors occurred, set the response as OK and return `true`. If any error was triggered, set the response with the error code/message and return `false`.

## 3. Parameter Analysis

| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| 1 | `handle` | `SessionHandle` | Database session handle for executing CBS (Co-business System) service calls. Provides the transactional context and database connection used to query service contract and customer data. |
| 2 | `scCall` | `ServiceComponentRequestInvoker` | Service Component invocation component. Used to dispatch CBS calls (e.g., `EKK0081A010CBS`, `ECK0011A010CBS`) to the backend service layer. Enables querying contract details, customer info, and authentication ID records. |
| 3 | `param` | `IRequestParameterReadWrite` | Request parameter object passed to CBS calls. Carries input/output data between this method and the CBS layer. Not directly modified by `chkKnrn` itself, but forwarded to each CBS invocation. |
| 4 | `fixedText` | `String` | User-defined string literal passed through to CBS calls. Used for logging, audit trails, or fixed text markers in CBS request payloads. |
| 5 | `ccMsg` | `Map<String, Object>` | CC (Common Component) message map carrying business context. Contains `channel` (wholesaler operator code — the originating channel for the password change request), `commonKey` (service contract number / service detail number), and `authenticationId` (the ISP authentication ID being changed). Also populated with the result (`returnCode`, `returnMessage`) on error. |

**Instance fields read by this method:**

| Field | Type | Business Description |
|-------|------|---------------------|
| `commonKey` | `String` | Service contract number (service detail work number) — extracted from `ccMsg`, used as the primary key for contract inquiries. |
| `opeDate` | `String` | Operation date — current business date fetched from `JPCBPCommon.getOpeDate()`, used as the service application date for contract lookups. |
| `sysid` | `String` | System ID of the customer — extracted from the contract inquiry response, used to query customer (wholesaler) details. |
| `updDtm` | `String` | Last update datetime — extracted from contract inquiry response, carried forward for later use in password initialization. |
| `ninshoId` | `String` | Authentication ID — extracted from the last authentication ID record, used for validation against the requested ID. |
| `ninshoIdPwd` | `String` | Authentication ID password — extracted alongside `ninshoId` from the auth ID inquiry. |

## 4. CRUD Operations / Called Services

### Pre-computed evidence from code analysis graph:

| CRUD | SC / CBS | SC Code | Entity / DB | Operation Description |
|------|----------|---------|-------------|----------------------|
| R | `callSC` (EKK0081A010CBS) | EKK0081A010 | KK_T_SVC_KEI (Service Contract) | Service Contract Inquiry — queries service contract details by common key and application date to verify contract existence and extract status, sysid, and update datetime. |
| R | `callSC` (ECK0011A010CBS) | ECK0011A010 | KK_T_CUS_KANRI (Customer Management) | Customer Inquiry — looks up customer record by sysid to retrieve the wholesaler operator code (orsjgsCd) for channel verification. |
| R | `callSC` (ECH0911A010CBS) | ECH0911A010 | KK_M_ORSJGS_T (Wholesaler Master / Application) | Wholesaler Application Inquiry — retrieves the wholesaler application period (start/end dates) to validate the operator is within their active service period. |
| R | `callSC` (EKK0171B001CBS) | EKK0171B001 | KK_T_NINSHO_ID (Authentication ID Master) | Authentication ID List Inquiry — retrieves all authentication IDs associated with the service contract, used to validate the requested ID exists and is the latest record. |

**Service Contract Details:**

- **EKK0081A010CBS (Service Contract Inquiry)**: Queries `KK_T_SVC_KEI` table for the service contract record matching the given common key (service contract number) and application date. Returns the service contract status (`svcKeiStat`), system ID (`sysid`), and last update datetime (`updDtm`).

- **ECK0011A010CBS (Customer Inquiry)**: Queries `KK_T_CUS_KANRI` (customer management) table using the `sysid` to retrieve the wholesaler operator code (`orsjgsCd`). Validates that the customer is properly registered under the service contract.

- **ECH0911A010CBS (Wholesaler Application Inquiry)**: Queries the wholesaler master table `KK_M_ORSJGS_T` (or equivalent master) to check the wholesaler's application period (`orsjgsTstaymd` → `orsjgsTendymd`). Ensures the wholesaler is within their valid operating period.

- **EKK0171B001CBS (Authentication ID List Inquiry)**: Queries `KK_T_NINSHO_ID` (authentication ID master) for all authentication IDs linked to the service contract. Uses search type `SAERCH_TYPE_IKT` (search by contract number), returns up to 1000 records. The method assumes the last record is the current one.

### Internal utility methods:

| CRUD | Method | Description |
|------|--------|-------------|
| - | `JPCBPCommon.getOpeDate(null)` | Retrieves the current operation date from the system configuration. |
| - | `JKKCommonUtil.isNull(value)` | Null-safety utility used to check if strings are null or empty. |
| - | `setResponse(ccMsg, returnCode, returnMessage)` | Writes the result into the `ccMsg` map for the caller to process. |

## 5. Dependency Trace

### Pre-computed evidence from code analysis graph:

No screen/batch entry points found within 8 hops. Direct callers found: 1 methods.

| # | Caller (Screen/Batch) | Call Chain (Full Path to this Method) | Terminal (SC / CRUD / Entity) |
|---|----------------------|--------------------------------------|-------------------------------|
| 1 | Method: `JKKNsidPwdChgOrsjgsCC.chgNsidPwd()` | `chgNsidPwd()` → `chkKnrn(handle, scCall, param, fixedText, ccMsg)` | EKK0081A010CBS [R] KK_T_SVC_KEI; ECK0011A010CBS [R] KK_T_CUS_KANRI; ECH0911A010CBS [R] KK_M_ORSJGS_T; EKK0171B001CBS [R] KK_T_NINSHO_ID; setResponse [-] ccMsg map |

**Call Chain Explanation:**

`chkKnrn()` is called as part of the ISP Authentication ID and Password Change workflow for wholesale distributors. The calling method `chgNsidPwd()` first performs preliminary checks (e.g., input validation), then calls `chkKnrn()` to perform the core related-entity validation. If `chkKnrn()` returns `true`, `chgNsidPwd()` proceeds with the actual password change operation (including calling `executeShkkaHakko()` for password initialization).

The method reaches four CBS endpoints, each performing a **Read (R)** operation on their respective entities:
- `EKK0081A010CBS` reads the service contract (KK_T_SVC_KEI)
- `ECK0011A010CBS` reads customer data (KK_T_CUS_KANRI)
- `ECH0911A010CBS` reads wholesaler application data (KK_M_ORSJGS_T)
- `EKK0171B001CBS` reads authentication ID records (KK_T_NINSHO_ID)

No Create, Update, or Delete operations are performed by this method. It is a **pure validation gate**.

## 6. Per-Branch Detail Blocks

**Block 1** — [INITIALIZATION] (L363)

> Extract business context from the ccMsg map and initialize local variables.

| # | Type | Code |
|---|------|------|
| 1 | SET | `channel = (String)ccMsg.get("channel")` // Wholesaler origin channel code |
| 2 | SET | `commonKey = (String)ccMsg.get("commonKey")` // Service contract number [Instance field] |
| 3 | SET | `authenticationId = (String)ccMsg.get("authenticationId")` // ISP Auth ID being changed |
| 4 | SET | `opeDate = JPCBPCommon.getOpeDate(null)` // Current operation date [Instance field] |
| 5 | SET | `returnCode = ""` // Initialize return code to empty string |
| 6 | SET | `returnMessage = ""` // Initialize return message to empty string |

**Block 2** — [IF] Contract Existence Check — Service Contract Inquiry (L372)

> Query the service contract to verify it exists for the given common key.

| # | Type | Code |
|---|------|------|
| 1 | SET | `ekk0081a010In` = Object[][] with TEMPLATE_ID_EKK0081A010, FUNC_CD_2, commonKey, opeDate // [FUNC_CD_2 = "2" (Business Operation)] |
| 2 | CALL | `callSC(handle, scCall, param, ekk0081a010In, fixedText, new EKK0081A010CBSMsg().getContents()).getCAANMsgList(EKK0081A010CBSMsg.EKK0081A010CBSMSG1LIST)` |

**Block 2.1** — [IF] Contract record exists (L383)

> Service contract record found. Extract service status, system ID, and update datetime.

| # | Type | Code |
|---|------|------|
| 1 | SET | `svcKeiStat = ekk0081a010Msg1List[0].getString(EKK0081A010CBSMsg1List.SVC_KEI_STAT)` // Service contract status code |
| 2 | SET | `sysid = ekk0081a010Msg1List[0].getString(EKK0081A010CBSMsg1List.SYSID)` // System ID [Instance field] |
| 3 | SET | `updDtm = ekk0081a010Msg1List[0].getString(EKK0081A010CBSMsg1List.LAST_UPD_DTM)` // Last update datetime [Instance field] |

**Block 2.2** — [ELSE] Contract record NOT found (L389)

> No service contract exists for the given common key. This is a fatal validation error.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1100` // "1100" — Contract not found error |
| 2 | SET | `returnMessage = JKKStrConst.RETURN_MESSAGE_KEI_EXISTS_CHECK_ERROR` // "Contract existence check error" |

**Block 3** — [IF] Wholesaler Operator Check — Conditional on Phase 1 passing (L395)

> `JKKCommonUtil.isNull(returnCode)` — No error from contract existence check. Proceed to wholesaler verification.

**Block 3.1** — [IF] Customer Inquiry (L398)

> Call CBS ECK0011A010 to query customer (wholesaler) data using the sysid.

| # | Type | Code |
|---|------|------|
| 1 | SET | `eck0011a010In` = Object[][] with TEMPLATE_ID_ECK0011A010, FUNC_CD_2, sysid, opeDate |
| 2 | CALL | `callSC(handle, scCall, param, eck0011a010In, fixedText, new ECK0011A010CBSMsg().getContents()).getCAANMsgList(ECK0011A010CBSMsg.ECK0011A010CBSMSG1LIST)` |

**Block 3.2** — [IF] Wholesaler record found (L406)

> Customer inquiry returned results. Extract and validate the wholesaler code.

| # | Type | Code |
|---|------|------|
| 1 | SET | `orsjgsCd = eck0011a010Msg1List[0].getString(ECK0011A010CBSMsg1List.ORSJGS_CD)` // Wholesaler operator code |

**Block 3.2.1** — [IF] Channel mismatch (L410)

> The originating channel does not match the wholesaler code in the customer record. Potential fraud or routing error.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1101` // "1101" — Wholesaler mismatch error |
| 2 | SET | `returnMessage = JKKStrConst.RETURN_MESSAGE_ORSJIGS_CHECK_ERROR` // "Wholesaler check error" |

**Block 3.2.2** — [ELSE] Channel matches (L415)

> Channel and wholesaler code match. Verify the wholesaler is within their active application period.

| # | Type | Code |
|---|------|------|
| 1 | SET | `ech0911a010In` = Object[][] with TEMPLATE_ID_ECH0911A010, FUNC_CD_2, channel |
| 2 | CALL | `callSC(handle, scCall, param, ech0911a010In, fixedText, new ECH0911A010CBSMsg().getContents()).getCAANMsgList(ECH0911A010CBSMsg.ECH0911A010CBSMSG1LIST)` |

**Block 3.2.2.1** — [IF] Wholesaler application found (L422)

> Wholesaler application record exists. Check the application period.

| # | Type | Code |
|---|------|------|
| 1 | SET | `orsjgsTstaymd = ech0911a010Msg1List[0].getString(ECH0911A010CBSMsg1List.ORSJGS_TSTAYMD)` // Wholesaler application start date [Instance field: extracted locally] |
| 2 | SET | `orsjgsTendymd = ech0911a010Msg1List[0].getString(ECH0911A010CBSMsg1List.ORSJGS_TENDYMD)` // Wholesaler application end date [Instance field: extracted locally] |

**Block 3.2.2.2** — [IF] Outside application period (L427)

> Current operation date (`opeDate`) is NOT between the start and end dates. `!(0 <= opeDate.compareTo(orsjgsTstaymd) && 0 <= orsjgsTendymd.compareTo(opeDate))`. The wholesaler is either not yet active or has expired.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1101` // "1101" — Wholesaler period error |
| 2 | SET | `returnMessage = JKKStrConst.RETURN_MESSAGE_ORSJIGS_CHECK_ERROR` // "Wholesaler check error" |

**Block 4** — [IF] Contract Status Check — Conditional on Phase 2 passing (L435)

> No errors from wholesaler check. Now validate the service contract status.

**Block 4.1** — [IF] Invalid contract status (L438)

> `svcKeiStat` is NOT one of the acceptable statuses. The condition checks: NOT equal to `CD00037_SHOSA_ZUMI` (020 — Completed), NOT equal to `CD00037_CNC_ZM` (Connection Pending), NOT equal to `CD00037_SVCTK_CHU` (Service Provisioning in Progress), NOT equal to `CD00037_STAT_PAUSE` (Paused), NOT equal to `CD00037_STAT_STP` (Suspended).

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1102` // "1102" — Invalid contract status error |
| 2 | SET | `returnMessage = JKKStrConst.RETURN_MESSAGE_KEI_STAT_CHECK_ERROR` // "Contract status check error" |

**Block 5** — [IF] Authentication ID Existence Check — Conditional on Phase 3 passing (L448)

> No errors from status check. Verify the authentication ID exists and matches.

**Block 5.1** — [IF] Auth ID List Inquiry (L450)

> Call CBS EKK0171B001 to query authentication IDs for the common key.

| # | Type | Code |
|---|------|------|
| 1 | SET | `ekk0171b001In` = Object[][] with TEMPLATE_ID_EKK0171B001, FUNC_CD_1, commonKey, SAERCH_TYPE_IKT, "1000", "1000", "1" |
| 2 | CALL | `callSC(handle, scCall, param, ekk0171b001In, fixedText, new EKK0171B001CBSMsg().getContents()).getCAANMsgList(EKK0171B001CBSMsg.EKK0171B001CBSMSG1LIST)` |

**Block 5.2** — [IF] Auth records found (L460)

> Authentication ID records exist. Extract from the LAST record (assumed single line, latest record).

| # | Type | Code |
|---|------|------|
| 1 | SET | `ninshoId = ekk0171b001Msg1List[...length-1].getString(EKK0171B001CBSMsg1List.NINSHO_ID)` // Auth ID [Instance field] |
| 2 | SET | `ninshoIdPwd = ekk0171b001Msg1List[...length-1].getString(EKK0171B001CBSMsg1List.NINSHO_ID_PWD)` // Auth ID password [Instance field] |

**Block 5.2.1** — [IF] Auth ID is null (L467)

> The last authentication ID record has a null ID. This indicates data inconsistency.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1103` // "1103" — Auth ID missing error |
| 2 | SET | `returnMessage = "Authentication ID existence check error"` // Inline Japanese: 認証ID存在チェックエラー |

**Block 5.2.2** — [IF] Auth ID mismatch (L472)

> The authentication ID from the database does NOT match the one provided in the request parameter.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1103` // "1103" — Auth ID mismatch error |
| 2 | SET | `returnMessage = "Authentication ID existence check error"` // Inline Japanese: 認証ID存在チェックエラー |

**Block 5.3** — [ELSE] No auth records found (L479)

> No authentication ID records exist for this common key.

| # | Type | Code |
|---|------|------|
| 1 | SET | `returnCode = JKKStrConst.RETURN_CD_1103` // "1103" — Auth ID missing error |
| 2 | SET | `returnMessage = "Authentication ID existence check error"` // Inline Japanese: 認証ID存在チェックエラー |

**Block 6** — [IF] Error Result (L486)

> `!JKKCommonUtil.isNull(returnCode)` — An error code was set during any of the four validation phases.

| # | Type | Code |
|---|------|------|
| 1 | CALL | `setResponse(ccMsg, returnCode, returnMessage)` // Write error result into ccMsg map |
| 2 | RETURN | `return false` // Validation failed |

**Block 7** — [RETURN] Success (L493)

> No errors occurred across all four validation phases. All checks passed.

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return true` // All validation checks passed |

## 7. Glossary

| Term | Type | Business Meaning |
|------|------|------------------|
| `commonKey` | Field | Service Contract Number — the unique identifier for a service contract line item, used as the primary key for all contract-related lookups. |
| `svcKeiStat` | Field | Service Contract Status — the current state of the service contract, stored as a code from master table CD00037. |
| `sysid` | Field | System ID — a unique customer identifier linking service contracts to customer records. |
| `updDtm` | Field | Last Update Datetime — timestamp of the most recent modification to the service contract record. |
| `orsjgsCd` | Field | Wholesaler Operator Code (卸先事業者コード) — the code identifying the wholesale distributor in the customer agreement. |
| `orsjgsTstaymd` | Field | Wholesaler Application Start Date (卸先事業者適用開始年月日) — the date from which the wholesaler's application becomes active. |
| `orsjgsTendymd` | Field | Wholesaler Application End Date (卸先事業者適用終了年月日) — the date until which the wholesaler's application remains valid. |
| `ninshoId` | Field | Authentication ID (認証ID) — the ISP login identifier stored in the authentication ID master table. |
| `ninshoIdPwd` | Field | Authentication ID Password (認証IDパスワード) — the password associated with the authentication ID. |
| `channel` | Field | Origin Channel (依存元区分) — the wholesaler operator code indicating the source/origin of the password change request. |
| `opeDate` | Field | Operation Date (運用日) — the current business date used for contract and application lookups. |
| RETURN_CD_1100 | Constant | Return code "1100" — Contract not found error (サービス契約不存在エラー). The service contract does not exist for the given common key. |
| RETURN_CD_1101 | Constant | Return code "1101" — Wholesaler operator check error (卸先事業者チェックエラー). Channel mismatch or wholesaler outside application period. |
| RETURN_CD_1102 | Constant | Return code "1102" — Contract status check error (契約状態チェックエラー). The service contract status is not in an acceptable state. |
| RETURN_CD_1103 | Constant | Return code "1103" — Authentication ID existence check error (認証ID存在チェックエラー). Auth ID missing, null, or does not match the requested ID. |
| CD00037_SHOSA_ZUMI | Constant | Status code "020" — Contract status: Completed (処理済). The service contract processing is complete. |
| CD00037_CNC_ZM | Constant | Status code for Connection Pending (接続済) — indicates a pending connection state where the service has been connected. |
| CD00037_SVCTK_CHU | Constant | Status code for Service Provisioning in Progress (サービス提供中) — the service is actively being provided. |
| CD00037_STAT_PAUSE | Constant | Status code for Paused (停止中) — the service contract is in a paused state. |
| CD00037_STAT_STP | Constant | Status code for Suspended (中断中) — the service contract is suspended (temporarily halted). |
| FUNC_CD_1 | Constant | Function code "1" — System/Administrative operation mode (from JPCModelConstant). |
| FUNC_CD_2 | Constant | Function code "2" — Business operation mode (from JPCModelConstant). |
| SAERCH_TYPE_IKT | Constant | Search type: Search by contract number (検索種別: 契約番号) — used in auth ID list inquiry to search by common key. |
| EKK0081A010CBS | CBS | Service Contract Inquiry Co-business System — queries the service contract table (KK_T_SVC_KEI) by common key and application date. |
| ECK0011A010CBS | CBS | Customer Inquiry Co-business System — queries customer management data (KK_T_CUS_KANRI) by sysid. |
| ECH0911A010CBS | CBS | Wholesaler Application Inquiry Co-business System — queries wholesaler master data (KK_M_ORSJGS_T) for application period validation. |
| EKK0171B001CBS | CBS | Authentication ID List Inquiry Co-business System — queries authentication ID master (KK_T_NINSHO_ID) for the service contract. |
| KK_T_SVC_KEI | DB Table | Service Contract Master — stores service contract details including status, sysid, and update timestamps. |
| KK_T_CUS_KANRI | DB Table | Customer Management Master — stores customer/wholesaler records linked by sysid. |
| KK_M_ORSJGS_T | DB Table | Wholesaler Master (卸先マスタ) — stores wholesaler operator information including application periods. |
| KK_T_NINSHO_ID | DB Table | Authentication ID Master — stores ISP authentication IDs and passwords linked to service contracts. |
| CD00037 | Master Table | Service Contract Status Master Code Table — defines valid values for service contract status (010=Received, 020=Completed, 030=Contracted, 100=In Service, 210=Suspended/Interrupted, 220=Paused, 910=Terminated, 920=Canceled). |
| CC | Abbreviation | Common Component — a shared business logic layer that provides reusable validation and processing functions. |
| CBS | Abbreviation | Co-business System — the backend service layer containing business logic and data access. |
| SC Code | Abbreviation | Service Component code — the identifier for a CBS service component (e.g., EKK0081A010SC). |
| `sensaki jigyousha` | Term | Wholesaler Operator (卸先事業者) — a B2B business partner that resells K-Opticom telecom services to end customers. |
| `chgNsidPwd` | Method | Change Nsid (Authentication ID) Password — the main password change method that calls `chkKnrn` for pre-validation. |
| `ninsyo` (認証) | Term | Authentication — refers to ISP login credentials (ID and password) used by wholesale distributors to access the K-Opticom portal. |