# Business Logic — JKKOrsjgsUseStpRlsRunCC.executeKktkSvcKei_UseStp() [152 LOC]

| Field | Value |
|-------|-------|
| Fully Qualified Name | `com.fujitsu.futurity.bp.custom.common.JKKOrsjgsUseStpRlsRunCC` |
| Layer | CC / Common Component (Service orchestration component) |
| Module | `common` (Package: `com.fujitsu.futurity.bp.custom.common`) |

## 1. Role

### JKKOrsjgsUseStpRlsRunCC.executeKktkSvcKei_UseStp()

This method implements the **equipment provider service contract usage suspension release** processing (機器提供サービス契約利用停止解除処理). It is a central orchestration method within the K-Opticom customer base system responsible for lifting suspension (stopping) of an equipment provider service contract — the type of contract that governs leased networking equipment such as routers, ONUs, and home gateways provided to customers alongside their fiber-optic service subscriptions.

The method performs a **multi-stage conditional decision flow** based on the type of equipment provider service contract and the current service status:

- **Equipment-specific contract path (親契約識別コード = "02")**: When the equipment belongs to a service contract line (contract circuit), this path extracts the parent service contract details and checks if the service combination warrants any action. For standard VoNU (Voice over NTP ONU) paired with net/phone services, or TV-only services, the method returns early with success since no equipment operation contract update is needed. For multi-function routers (C024) or home gateways (C025) paired with home, maison, or mansion price groups, or telephone services, it prepares and invokes an equipment operation service contract update (`updateKkopSvcKeiTran`).

- **General suspension release path**: When the service contract status is "220" (Suspended / 利用停止中), this path determines whether the prior state was "210" (休止 — rest/interruption, a pre-suspension state). If so, it calls a specialized suspension release SC (`getEKK0341C131SC`) for interrupted services; otherwise it calls the standard suspension release SC (`getEKK0341C130SC`). After the SC returns successfully, it recursively delegates to `executeKkopSvcKei_UseStp` for the equipment-specific service key number to finalize the release.

The method implements the **delegation pattern** with **early return optimization** and **recursive dispatch**, serving as a shared utility invoked by `executeKktkSvcKei_UseStp2()` and `executeUseStpRlsMain()`. It acts as the coordination hub that decides which downstream processing path to take based on business rules around equipment type, service type, and suspension state.

## 2. Processing Pattern (Detailed Business Logic)

```mermaid
flowchart TD
    START(["executeKktkSvcKei_UseStp params"])
    STATUS_SET["SET statusCode = 0"]
    STEP1["CALL getEKK0341A010SC - Fetch equipment provider service contract info"]
    STEP1_CHECK{"statusCode != 0?"}
    STEP1_RETURN["RETURN statusCode"]
    HASH_GET["GET eKK0341A010Hash from resultHash"]
    CHK_CHECK{"chkTarget is true?"}
    TARGET_CHECK["CALL isKktkSvcKeiTargetData - Check if target service contract"]
    TARGET_RETURN["RETURN statusCode"]
    DATA_EXTRACT["EXTRACT kktk_svc_kei_stat, kktk_svc_cd, oya_kei_skbt_cd from hash"]
    OYA_CHECK{"OYA_KEI_SKBT_CD_KAISEN = \"02\" (Service Contract Line Equipment)?"}
    EKK0081_GET["GET eKK0081A010Hash from resultHash"]
    SVC_DATA["EXTRACT svc_cd, prc_grp_cd from EKK0081 hash"]
    SKIP_CHECK{"Skip condition met?"}
    SKIP_RETURN["RETURN 0 - No action needed"]
    MFR_CHECK{"kktk_svc_cd is C024 or C025?"}
    PREP_CHECK{"SVC_CD_NET and home price group?"}
    UPDATE_PREP["PREPARE update data with ido_div 00063"]
    UPDATE_CALL["CALL updateKkopSvcKeiTran - Update equipment operation service contract"]
    UPDATE_RETURN["RETURN 0"]
    STAT_CHECK{"kktk_svc_kei_stat equals 220?"}
    STAT_MAP["GET svkeiStatMap from resultHash"]
    KYUS_CHECK{"useStpBfSvcKeiStat equals 210?"}
    CALL_131["CALL getEKK0341C131SC - Suspended service contract release"]
    CALL_131_CHECK{"statusCode != 0?"}
    CALL_131_RETURN["RETURN statusCode"]
    CALL_130["CALL getEKK0341C130SC - Service contract suspension release"]
    CALL_130_CHECK{"statusCode != 0?"}
    CALL_130_RETURN["RETURN statusCode"]
    RECURSE["CALL executeKkopSvcKei_UseStp - Update service contract usage"]
    FINAL_RETURN["RETURN 0"]

    START --> STATUS_SET --> STEP1 --> STEP1_CHECK
    STEP1_CHECK -- Yes --> STEP1_RETURN
    STEP1_CHECK -- No --> HASH_GET --> CHK_CHECK
    CHK_CHECK -- No --> DATA_EXTRACT
    CHK_CHECK -- Yes --> TARGET_CHECK --> TARGET_RETURN
    DATA_EXTRACT --> OYA_CHECK
    OYA_CHECK -- No --> STAT_CHECK
    OYA_CHECK -- Yes --> EKK0081_GET --> SVC_DATA --> SKIP_CHECK
    SKIP_CHECK -- Yes --> SKIP_RETURN
    SKIP_CHECK -- No --> MFR_CHECK
    MFR_CHECK -- Yes --> PREP_CHECK --> UPDATE_PREP --> UPDATE_CALL --> UPDATE_RETURN
    MFR_CHECK -- No --> STAT_CHECK
    STAT_CHECK -- No --> FINAL_RETURN
    STAT_CHECK -- Yes --> STAT_MAP --> KYUS_CHECK
    KYUS_CHECK -- Yes --> CALL_131 --> CALL_131_CHECK
    CALL_131_CHECK -- Yes --> CALL_131_RETURN
    CALL_131_CHECK -- No --> CALL_130
    CALL_130 -- Yes --> CALL_130_CHECK
    CALL_130_CHECK -- Yes --> CALL_130_RETURN
    CALL_130_CHECK -- No --> RECURSE --> FINAL_RETURN
```

**Branch logic summary:**

1. **Initialization** — Set `statusCode = 0` (success default) and fetch the equipment provider service contract info via `getEKK0341A010SC`. Any failure here returns immediately.

2. **chkTarget flag check** — If `chkTarget` is true, verify that the service contract is an actual target for suspension release via `isKktkSvcKeiTargetData`. If it is not a target, return early.

3. **Data extraction** — Read the service contract status (`kktk_svc_kei_stat`), equipment provider service code (`kktk_svc_cd`), and parent contract identification code (`oya_kei_skbt_cd`) from the fetched hash map.

4. **Parent contract = "02" (Service Contract Line Equipment)** — When the equipment is tied to a service contract line (contract circuit within the service), extract the parent service contract (EKK0081A010) to determine the service code (`svc_cd`) and price group code (`prc_grp_cd`).

5. **Skip early return condition** — If the equipment is VoNU (C013) paired with net or phone service, OR if it is non-VoNU paired with TV service, return 0 immediately since no equipment operation contract update is required.

6. **Multi-function router / home gateway path** — If the equipment is a multi-function router (C024) or home gateway (C025) AND (paired with net service in a home/maison/mansion price group OR paired with telephone service), prepare the equipment operation update data and call `updateKkopSvcKeiTran`.

7. **General suspension release** — If the service contract status is "220" (Suspended), retrieve the prior service status and branch: if the prior status was "210" (休止), call the specialized suspension release SC (`getEKK0341C131SC`); otherwise call the standard suspension release SC (`getEKK0341C130SC`). After the SC call, recursively delegate to `executeKkopSvcKei_UseStp` for the equipment-specific release.

## 3. Parameter Analysis

| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| 1 | `handle` | `SessionHandle` | Session management handle carrying database connection context and session state. Used by all downstream SC calls and data access operations. |
| 2 | `param` | `IRequestParameterReadWrite` | Request parameter object containing model groups and control maps. Used to store intermediate data for the equipment operation service contract update (`JKKKkopSvcUseKeiUpdCC`) and to retrieve prior service status maps. |
| 3 | `requestParam` | `HashMap<String, Object>` | Request parameters passed through to service component calls. Carries business context such as operation date, tenant ID, and other operational metadata needed by CBS calls. |
| 4 | `resultHash` | `HashMap<String, Object>` | Results hash map that accumulates output from SC calls. Key entries: `EKK0341A010` (equipment provider service contract data), `EKK0081A010` (parent service contract data), `JKKGetSvkeiStat` (prior service status map), and results from `getEKK0341C130SC`/`getEKK0341C131SC`. |
| 5 | `prm_svc_kei_no` | `String` | Service contract number — the top-level service contract identifier. Used as a filter target when `chkTarget` is true (passed to `isKktkSvcKeiTargetData`) and as input to the recursive `executeKkopSvcKei_UseStp` call. |
| 6 | `chkTarget` | `boolean` | Flag indicating whether to verify this service contract is an actual target for suspension release processing. When `true`, the method calls `isKktkSvcKeiTargetData` to validate. When `false`, this check is skipped (used in internal recursive calls). |

**Instance fields / external state read:**

| Field | Type | Business Description |
|-------|------|---------------------|
| `oPE_DATE` | `String` | Operation date (運用手日) — the current operational date used as the suspension release effective date. Set in the constructor from `JCCBPCommon.getOpeDate(null)`. |

## 4. CRUD Operations / Called Services

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

| CRUD | SC / CBS | SC Code | Entity / DB | Operation Description |
|------|----------|---------|-------------|----------------------|
| R | `getEKK0341A010SC` | EKK0341A010SC | KK_T_KKTK_SVC_KEI (Equipment Provider Service Contract table) | Reads equipment provider service contract details (status, service code, parent contract ID) for the given service key number |
| R | `isKktkSvcKeiTargetData` | - | KK_T_KKTK_SVC_KEI | Checks whether the specified service contract is a valid target for suspension release processing |
| R | `getEKK0341C131SC` | EKK0341C130SC | KK_T_KKTK_SVC_KEI | Reads the equipment provider service contract for suspension release — specialized path for services previously in 休止 (rest/interruption) status |
| R | `getEKK0341C130SC` | EKK0341C130SC | KK_T_KKTK_SVC_KEI | Reads the equipment provider service contract for suspension release — standard path for suspended services |
| U | `JKKKkopSvcUseKeiUpdCC.updateKkopSvcKeiTran` | KKKOPSVCUSEKEI | KK_T_KKOP_SVC_USE_KEI (Equipment Operation Service Contract table) | Updates the equipment operation service contract with suspension release information (ido_div, suspension release date, last update datetime) |
| C | `JKKOrsjgsUseStpRlsRunCC.createUserData` | - | In-memory | Creates a user-defined data entry in the param object for the equipment operation update preparation |
| - | `executeKkopSvcKei_UseStp` | - | KK_T_SVC_KEI, KK_T_KKTK_SVC_KEI | Recursively updates the service contract usage suspension/release state for the equipment-specific service key number |

## 5. Dependency Trace

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

No screen/batch entry points found within 8 hops. Direct callers found: 2 methods.
Terminal operations from this method: `executeKkopSvcKei_UseStp` [-], `getEKK0341C130SC` [R], `getEKK0341C131SC` [R], `updateKkopSvcKeiTran` [U], `createUserData` [C], `isKktkSvcKeiTargetData` [-], `getEKK0341A010SC` [R]

| # | Caller (Screen/Batch) | Call Chain (Full Path to this Method) | Terminal (SC / CRUD / Entity) |
|---|----------------------|--------------------------------------|-------------------------------|
| 1 | Method: `executeKktkSvcKei_UseStp2()` | `executeKktkSvcKei_UseStp2()` -> `executeKktkSvcKei_UseStp` | `getEKK0341A010SC [R] KK_T_KKTK_SVC_KEI`, `updateKkopSvcKeiTran [U] KK_T_KKOP_SVC_USE_KEI`, `getEKK0341C130SC [R] KK_T_KKTK_SVC_KEI` |
| 2 | Method: `executeUseStpRlsMain()` | `executeUseStpRlsMain()` -> `executeKktkSvcKei_UseStp` | `getEKK0341A010SC [R] KK_T_KKTK_SVC_KEI`, `isKktkSvcKeiTargetData [-]`, `executeKkopSvcKei_UseStp [-] KK_T_SVC_KEI` |

## 6. Per-Branch Detail Blocks

**Block 1** — [INITIALIZATION] (L1289-1290)

Initialize processing variables and fetch equipment provider service contract data.

| # | Type | Code |
|---|------|------|
| 1 | SET | `statusCode = 0` // Success default status code [-> CONSTANT=0] |

**Block 2** — [CALL] (L1295-1299)

Fetch the equipment provider service contract (機器提供サービス契約) via service component.

| # | Type | Code |
|---|------|------|
| 1 | CALL | `getEKK0341A010SC(param, handle, requestParam, resultHash)` // Fetch equipment provider service contract [-> SC: EKK0341A010SC] |
| 2 | SET | `statusCode = result of getEKK0341A010SC()` |
| 3 | IF | `statusCode != 0` // Error detected in SC call |
| 4 | RETURN | `return statusCode` // Propagate error code |

**Block 3** — [SET] (L1301)

Extract the equipment provider service contract result from the shared results hash.

| # | Type | Code |
|---|------|------|
| 1 | SET | `eKK0341A010Hash = resultHash.get("EKK0341A010")` // CAST to HashMap<String,Object> [-> TEMPLATE_ID_EKK0341A010 = "EKK0341A010"] |

**Block 4** — [IF: chkTarget branch] (L1305-1311)

Conditional target verification: only validate the service contract is a suspension release target when the `chkTarget` flag is true (external entry). For internal recursive calls, this check is bypassed.

| # | Type | Code |
|---|------|------|
| 1 | IF | `chkTarget` |
| 2 | CALL | `isKktkSvcKeiTargetData(param, handle, requestParam, resultHash, prm_svc_kei_no, eKK0341A010Hash)` // Verify this is a valid target [-> SC: isKktkSvcKeiTargetData] |
| 3 | IF | `isKktkSvcKeiTargetData` returns false |
| 4 | RETURN | `return statusCode` // Not a target, exit early |

**Block 5** — [DATA EXTRACTION] (L1314-1320)

Extract key fields from the fetched equipment provider service contract hash.

| # | Type | Code |
|---|------|------|
| 1 | SET | `kktk_svc_kei_stat = eKK0341A010Hash.get(KKTK_SVC_KEI_STAT)` // Service contract status [-> from EKK0341A010CBSMsg1List.KKTK_SVC_KEI_STAT] |
| 2 | SET | `kktk_svc_cd = eKK0341A010Hash.get(KKTK_SVC_CD)` // Equipment provider service code [-> from EKK0341A010CBSMsg1List.KKTK_SVC_CD] |
| 3 | SET | `oya_kei_skbt_cd = eKK0341A010Hash.get(OYA_KEI_SKBT_CD)` // Parent contract identification code [-> from EKK0341A010CBSMsg1List.OYA_KEI_SKBT_CD] |

**Block 6** — [IF: Parent Contract Identification Code = "02" (Service Contract Line Equipment)] (L1323-1428)

When the parent contract identification code equals "02", the equipment is tied to a service contract line (contract circuit). This branch handles equipment that is part of the service subscription itself.

> 親契約識別コード=02（サービス契約回線内に属する機器）の場合 — When the parent contract identification code is "02" (equipment belonging within the service contract line)

| # | Type | Code |
|---|------|------|
| 1 | IF | `OYA_KEI_SKBT_CD_KAISEN.equals(oya_kei_skbt_cd)` [-> CONSTANT="02"] |
| 2 | SET | `eKK0081A010Hash = resultHash.get("EKK0081A010")` // Get parent service contract data [-> TEMPLATE_ID_EKK0081A010 = "EKK0081A010"] |

**Block 6.1** — [DATA EXTRACTION] (L1331-1333)

Extract the service code and price group code from the parent service contract.

| # | Type | Code |
|---|------|------|
| 1 | SET | `svc_cd = eKK0081A010Hash.get(SVC_CD)` // Service code [-> from EKK0081A010CBSMsg1List.SVC_CD] |
| 2 | SET | `prc_grp_cd = eKK0081A010Hash.get(PRC_GRP_CD)` // Price group code [-> from EKK0081A010CBSMsg1List.PRC_GRP_CD] |

**Block 6.2** — [IF: Skip early return condition] (L1337-1345)

If the service combination is VoNU (C013) paired with net (01) or phone (02) service, OR if it is non-VoNU paired with TV service (03), no action is needed and the method returns 0. This handles cases where the equipment is naturally managed by the parent service contract without a separate equipment operation contract.

> eo光ネット, eo光電話でVONUの場合、eo光TVでVONU以外の場合、スルー — For eo光net/eo光phone with VONU, or eo光TV without VONU, skip |

| # | Type | Code |
|---|------|------|
| 1 | IF | `(KKTK_SVC_CD_VONU.equals(kktk_svc_cd) && (SVC_CD_NET.equals(svc_cd) || SVC_CD_TEL.equals(svc_cd)))` [-> VONU="C013", NET="01", TEL="02"] |
| 2 | IF-ELSEIF | `|| (!KKTK_SVC_CD_VONU.equals(kktk_svc_cd) && SVC_CD_TV.equals(svc_cd))` [-> TV="03"] |
| 3 | RETURN | `return 0` // Skip — no equipment operation contract needed |

**Block 6.3** — [IF: Multi-function Router / Home Gateway path] (L1350-1427)

If the equipment is a multi-function router (C024) or home gateway (C025) AND (paired with net service (01) in a home (02)/maison (03)/mansion (04) price group, OR paired with telephone service (02)), prepare and execute the equipment operation service contract update.

> 機器提供サービスコードが多機能ルータ(C024)又は、ホームゲートウェイ(C025)かつ、サービスコードがeo光ネット(01)かつ、料金グループコードがホーム(02)、メゾン(03)、マンション(04)のいずれかである場合、または、機器提供サービスコードが多機能ルータ(C024)又は、ホームゲートウェイ(C025)かつ、サービスコードがeo光電話(02)である場合 — When equipment service code is multi-function router or home gateway AND paired with net/home-group or telephone |

| # | Type | Code |
|---|------|------|
| 1 | IF | `(KKTK_SVC_CD_MFR.equals(kktk_svc_cd) \|\| KKTK_SVC_CD_HGW.equals(kktk_svc_cd))` [-> MFR="C024", HGW="C025"] |
| 2 | AND | AND `((SVC_CD_NET.equals(svc_cd) && (PCRS_GRP_HOME.equals(prc_grp_cd) \|\| PCRS_GRP_MAISON.equals(prc_grp_cd) \|\| PCRS_GRP_MANSION.equals(prc_grp_cd))) \|\| SVC_CD_TEL.equals(svc_cd))` [-> HOME="02", MAISON="03", MANSION="04"] |
| 3 | SET | `workKkopSvcUseKeiUpdDataKey = "JKKKkopSvcUseKeiUpdCC"` // Map key for update data |
| 4 | CALL | `createUserData(param, workKkopSvcUseKeiUpdDataKey)` // Create user data entry in param |
| 5 | SET | `outMap = param.getData(workKkopSvcUseKeiUpdDataKey)` // Get the map for building update info |
| 6 | SET | `trgtDataList = new ArrayList<HashMap<String, Object>>()` // Target data list for update |
| 7 | SET | `kkopKeiUpdInfo = new HashMap<String, Object>()` // Update info container |
| 8 | SET | `kkopKeiUpdInfo.put(KEY_SVC_KEI_NO, eKK0081A010Hash.get(SVC_KEI_NO))` // Service contract number [-> from EKK0081A010CBSMsg1List.SVC_KEI_NO] |
| 9 | SET | `kkopKeiUpdInfo.put(KEY_KKTK_SVC_KEI_NO, eKK0341A010Hash.get(KKTK_SVC_KEI_NO))` // Equipment provider service contract number [-> from EKK0341A010CBSMsg1List.KKTK_SVC_KEI_NO] |
| 10 | SET | `kkopKeiUpdInfo.put(KEY_IDO_DIV, IDO_DIV_USESTPRLS)` // Distinction (suspension release) [-> CONSTANT="00063"] |
| 11 | SET | `kkopKeiUpdInfo.put(KEY_SVC_STP_RLS_YMD, oPE_DATE)` // Service suspension release date (operation date) |
| 12 | SET | `kkopKeiUpdInfo.put(KEY_UPD_DTM_BF, eKK0341A010Hash.get(LAST_UPD_DTM))` // Last update datetime (before update) [-> from EKK0341A010CBSMsg1List.LAST_UPD_DTM] |
| 13 | EXEC | `trgtDataList.add(kkopKeiUpdInfo)` // Add update info to target list |
| 14 | EXEC | `outMap.put(KEY_TRGT_DATA_LIST, trgtDataList)` // Store target list in outMap |
| 15 | NEW | `kkopSvcUseKeiUpdCC = new JKKKkopSvcUseKeiUpdCC()` // Instantiate update component |
| 16 | CALL | `kkopSvcUseKeiUpdCC.updateKkopSvcKeiTran(handle, param, workKkopSvcUseKeiUpdDataKey)` // Call equipment operation service update |
| 17 | RETURN | `return 0` // Update complete |

**Block 7** — [IF: Suspension status check] (L1431-1433)

When the service contract status is "220" (Suspended / 利用停止中), enter the general suspension release processing path.

> 停止中の場合 — If suspended |

| # | Type | Code |
|---|------|------|
| 1 | IF | `SVC_KEI_STAT_STP.equals(kktk_svc_kei_stat)` [-> CONSTANT="220"] |

**Block 7.1** — [SET] (L1433-1434)

Retrieve the prior service status map from the results hash.

| # | Type | Code |
|---|------|------|
| 1 | SET | `svkeiStatMap = resultHash.get("JKKGetSvkeiStat")` // Get prior service status map [-> MAP_KEY_GET_SVKEI_STAT = "JKKGetSvkeiStat"] |
| 2 | SET | `useStpBfSvcKeiStat = svkeiStatMap.get(LAST_KK0081_STAT)` // Prior service status before suspension [-> "last_kk0081_stat"] |

**Block 7.2** — [IF: Prior status was 休止 (Rest/Interruption)] (L1436-1446)

If the status before suspension was "210" (休止), the service was in a rest/interruption state. Use the specialized suspension release service component for suspended services that were previously in rest status.

> 利用停止前が休止・中断中だった場合 — If the state before suspension was rest/interruption |

| # | Type | Code |
|---|------|------|
| 1 | IF | `SVC_KEI_STAT_KYUS.equals(useStpBfSvcKeiStat)` [-> CONSTANT="210"] |
| 2 | CALL | `getEKK0341C131SC(param, handle, requestParam, resultHash)` //休止中機器提供サービス契約停止解除 [-> SC: EKK0341C131SC] |
| 3 | SET | `statusCode = result of getEKK0341C131SC()` |
| 4 | IF | `statusCode != 0` |
| 5 | RETURN | `return statusCode` // Propagate error |

**Block 7.3** — [ELSE: Standard suspension release] (L1448-1458)

For all cases other than 休止 (the service was suspended normally, not from a rest/interruption state), use the standard suspension release service component.

> 休止・中断以外はサービス提供中とする — Treat as service provision for cases other than rest/interruption |

| # | Type | Code |
|---|------|------|
| 1 | ELSE | `SVC_KEI_STAT_KYUS` was not "210" |
| 2 | CALL | `getEKK0341C130SC(param, handle, requestParam, resultHash)` // 機器提供サービス契約停止解除 [-> SC: EKK0341C130SC] |
| 3 | SET | `statusCode = result of getEKK0341C130SC()` |
| 4 | IF | `statusCode != 0` |
| 5 | RETURN | `return statusCode` // Propagate error |

**Block 7.4** — [CALL: Recursive equipment-specific release] (L1460-1468)

After the service contract suspension release SC completes successfully, delegate to the equipment-specific service contract usage suspension release method. This final step updates the service contract usage state for the specific equipment provider service key number.

| # | Type | Code |
|---|------|------|
| 1 | CALL | `executeKkopSvcKei_UseStp(handle, param, requestParam, resultHash, prm_svc_kei_no, eKK0341A010Hash.get(KKTK_SVC_KEI_NO))` // Equipment operation service contract usage suspension/release [recursive call with equipment-specific key number] |

**Block 8** — [RETURN] (L1470)

| # | Type | Code |
|---|------|------|
| 1 | RETURN | `return 0` // Success — no suspension release processing was needed |

## 7. Glossary

| Term | Type | Business Meaning |
|------|------|------------------|
| `kktk_svc_kei_no` | Field | Equipment Provider Service Contract Number — unique identifier for a contract governing leased networking equipment (router, ONU, home gateway) provided to the customer |
| `kktk_svc_kei_stat` | Field | Equipment Provider Service Contract Status — current status code of the equipment contract (e.g., "220" = suspended) |
| `kktk_svc_cd` | Field | Equipment Provider Service Code — identifies the type of equipment (e.g., "C013" = VoNU, "C024" = multi-function router, "C025" = home gateway) |
| `oya_kei_skbt_cd` | Field | Parent Contract Identification Code — identifies whether the equipment is tied to the parent service contract line (="02") or managed independently |
| `svc_kei_no` | Field | Service Contract Number — the top-level identifier for the customer's service subscription |
| `svc_kei_stat` | Field | Service Contract Status — overall status of the service contract |
| `svc_cd` | Field | Service Code — identifies the type of service (e.g., "01" = eo光net, "02" = eo光phone, "03" = eo光TV) |
| `prc_grp_cd` | Field | Price Group Code — identifies the housing/price category (e.g., "02" = home, "03" = maison, "04" = mansion) |
| `ido_div` | Field | Distinction Division — classification code for the type of transaction (e.g., "00063" = usage suspension release) |
| `svc_stp_rls_ymd` | Field | Service Suspension Release Year-Month-Day — the effective date of the suspension release operation |
| VoNU | Business term | Voice over NTP ONU — a type of optical network unit that supports voice telephony over IP, equipment code "C013" |
| Multi-function Router | Business term | A networking device providing routing, switching, and WiFi functionality — equipment code "C024" |
| Home Gateway | Business term | A residential gateway device combining modem, router, and WiFi — equipment code "C025" |
| eo光ネット | Business term | eo光 Fiber Internet — NTT东日本's fiber-to-the-home internet service (service code "01") |
| eo光電話 | Business term | eo光 Voice Phone — NTT东日本's fiber-optic voice telephony service (service code "02") |
| eo光TV | Business term | eo光 Digital TV — NTT东日本's fiber-optic digital television service (service code "03") |
| 利用停止中 (Youtei Teishichuu) | Business term | Service Suspended — status code "220", indicating the service contract is currently suspended (stopped) |
| 休止 (Kyushu) | Business term | Rest/Interruption — status code "210", a pre-suspension state where the service is temporarily halted (e.g., during moving or seasonal suspension) |
| 利用停止解除 (Youtei Teishi Kaijo) | Business term | Service Suspension Release — the operation of reactivating a suspended service contract |
| 親契約回線 (Oya Kei Kaisen) | Business term | Parent Contract Line — a service contract line within which equipment contracts are nested; equipment in this category is managed through the parent service contract rather than independently |
| 機器提供サービス (Kiki Teikyo Service) | Business term | Equipment Provider Service — a contract type for leased networking equipment (routers, ONUs, home gateways) provided alongside the broadband/TV/phone service subscription |
| 機器オペレーションサービス契約 (Kiki Operation Service Contract) | Business term | Equipment Operation Service Contract — the contract governing the operational status of leased equipment, including whether it is active, suspended, or released |
| JKKKkopSvcUseKeiUpdCC | Class | Equipment Operation Service Contract Usage Update Common Component — handles updates to the equipment operation service contract status |
| getEKK0341A010SC | SC | Service Component for reading equipment provider service contract details (EKK0341A010) |
| getEKK0341C130SC | SC | Service Component for standard service contract suspension release processing |
| getEKK0341C131SC | SC | Service Component for suspension release of services that were previously in 休止 (rest/interruption) status |
| updateKkopSvcKeiTran | Method | Equipment Operation Service Contract Transaction Update — updates the equipment operation service contract with suspension/release information |
| chkTarget | Parameter | Target check flag — determines whether the method validates that the service contract is an actual target for suspension release |
| oPE_DATE | Field | Operation Date — the system's current operational date, obtained from `JCCBPCommon.getOpeDate()`, used as the effective date for the suspension release |
| KK_T_KKTK_SVC_KEI | Table | Equipment Provider Service Contract Master Table — stores the contract records for leased networking equipment |
| KK_T_KKOP_SVC_USE_KEI | Table | Equipment Operation Service Contract Usage Table — stores operational status records for equipment contracts |
| TEMPLATE_ID_EKK0341A010 | Constant | Result hash key "EKK0341A010" — used to store/retrieve equipment provider service contract data |
| TEMPLATE_ID_EKK0081A010 | Constant | Result hash key "EKK0081A010" — used to store/retrieve parent service contract data |
| MAP_KEY_GET_SVKEI_STAT | Constant | Result hash key "JKKGetSvkeiStat" — used to store/retrieve prior service status information |