cobol-tna-system/詳細設計書/詳細設計書_SHA06TWM.md

# 詳細設計書

## 基本情報

| # | 項目 | 内容 |
|---|------|------|
| 1 | システム名 | 社会保険管理システム |
| 2 | プログラムID | SHA06TWM |
| 3 | プログラム名 | 保険料率適用・控除計算処理 |
| 4 | PGMタイプ | メイン |
| 5 | PGMパターン | マッチング(M:N→M:N 2段階) |
| 6 | 機能概要 | 従業員保険情報データ(EMP-INSURANCE)をもとに、DB2 INSURANCE-RATESとAPPLICABLE-RULESの2段階M:Nマッチングで保険料を算出する。 |
| 7 | | 第1段階(M×N)：各従業員の給与等級に対応する保険料率をDB2より取得し、保険料を計算 |
| 8 | | 第2段階(M:N)：年齢・扶養人数・地域コードの条件に合致する適用ルールを探索し、料率を調整後、控除結果を出力 |

※PGMタイプ：メイン、サブ
※PGMパターン：マッチング(1:1、1:N、N:1、M:N)、レイアウト編集のみ(GETPUT)、振り分け(IF文、EVALUATE文)、キーブレイク(集計、集約、集計・集約の以外)、DB更新

### 前提条件

| NO | 対象ファイル | 条件 |
|----|-------------|------|
| 1 | ファイルR01（EMP-INSURANCE） | 社員番号(EMP-ID)の昇順ソート済 |
| 2 | ファイルR02（APPLICABLE-RULES） | ルールコード(RULE-CODE)の昇順ソート済 |

### 使用ファイル一覧

| NO | 使用ファイル/DB名 | 識別子 | DD名 | I/O | COPY群 | 形式 | ブロック | レコード長 | 媒体 | 備考 |
|----|------------------|--------|------|-----|--------|------|---------|-----------|------|------|
| 1 | EMP-INSURANCE | R01 | SHA06R01 | I | SHA02REC | FB | | 200 | PS | 従業員保険情報 |
| 2 | APPLICABLE-RULES | R02 | SHA06R02 | I | 自前(80B) | FB | | 80 | PS | 適用ルール定義テーブル |
| 3 | DEDUCTED-RESULT | W01 | SHA06W01 | O | SHA06REC | FB | | 300 | PS | 保険料確定結果 |
| 4 | ERROR-LOG | W02 | SHA06W02 | O | ZAN05REC | VB | | 200 | PS | エラー退避 |
| 5 | INSURANCEDB | DB | — | I | — | DB2 | — | — | DASD | DB2: INSURANCE-RATES |
| 6 | SALARYDB | DB | — | I | — | DB2 | — | — | DASD | DB2: EMP-MASTER（誕生日・扶養人数・地域コード取得） |

### キー項目一覧

| NO | ファイル名 | ソート条件(キー項目) | キー条件(マッチング/キーブレイク) |
|----|-----------|---------------------|-------------------------------------------|
| 1 | ファイルR01 | EMP-ID | EMP-ID（第1段階） |
| 2 | ファイルR02 | RULE-CODE | 年齢・扶養人数・地域コード（第2段階, M:N） |

### 使用モジュール一覧

| NO | 機能 | プログラムID | 使用COPY名 |
|----|------|-------------|-----------|
| 1 | 運用日付取得SUB | SUB01DAT | SHADATAC |
| 2 | メッセージ編集出力SUB | SUB02MSG | SHAMSGAC |
| 3 | ABEND処理SUB | SUB03END | SHAENDAC |

---

## 処理詳細

```
1.初期処理（1000ITTSOR）
  1-1.開始メッセージ出力
    【メッセージ編集】
    メッセージ番号：1(開始メッセージ)
  1-2.コンパイル日時出力
    【メッセージ編集】
    メッセージ番号：33(コンパイル日時)
    PARM1：コンパイル日時
    PARM2：'COMPILED'
  1-3.ワークエリアの初期化
  1-4.運用日付取得SUB(SUB01DAT）により運用日を取得する。
    復帰コード≠ZEROの場合、メッセージを出力し、ABEND処理SUBを呼び出し異常終了する。
    【メッセージ編集】
    メッセージ番号：5(サブエラー)
    PARM1：'SUB01DAT'
    PARM2：復帰コード
    【ABEND処理SUB】
    ABENDコード:999
  1-5.使用ファイルのオープン
  1-6.DB接続
    EXEC SQL CONNECT TO 'data/INSURANCEDB.db'
  1-7.R02（APPLICABLE-RULES）を全件読み込み、内部テーブル(RULE-TBL)に格納する。（1110R02LDASOR）
  1-8.R01を読み込む。（1100R01INNSOR)(1回目)

2.主処理（2000MAJSOR)(R01を全て読み終えるまで下記を繰り返す）
  2-1.第1段階：保険料率M×Nマッチング（DB2 INSURANCE-RATES）（2010RATESOR）
    2-1-1.EMP-INSURANCEのGRADE-CODE（等級コード）をもとに
          DB2 INSURANCE-RATESテーブルをSELECT
    2-1-2.SQLCODE=0の場合→健康保険料率・厚生年金保険料率を取得
    2-1-3.SQLCODE=100の場合（該当なし）→ERROR-LOGに出力
    2-1-4.SQLCODE<0の場合→ERROR-LOGに出力、処理継続
    2-1-5.保険料計算
      HEALTH-PREMIUM = MONTHLY-AMOUNT × HEALTH-RATE / 1000000
      PENSION-PREMIUM = MONTHLY-AMOUNT × PENSION-RATE / 1000000
    2-1-6.COMPUTE文を使用し、ON SIZE ERROR処理を実装
  2-2.第2段階：適用ルールM:Nマッチング（APPLICABLE-RULES）（2020RULESCOL）
    2-2-1.年齢算出（運用日付 - BIRTH-DATEで満年齢）
     2-2-2.SALARYDB.EMP-MASTERをSELECTし、BIRTH-DATE・DEPENDENT-COUNT・
           REGION-CODEを取得。SQLCODE異常→ERROR-LOG出力。
     2-2-3.RULE-TBLを線形探索し、以下の条件すべて合致するルールを検索
       AGE >= AGE-FROM AND AGE <= AGE-TO
       DEPENDENTS >= DEPENDENTS-FROM AND DEPENDENTS <= DEPENDENTS-TO
       REGION-CODE = DBV-REGION-CODE
     2-2-4.合致ルールあり→HEALTH-RATE-ADJ / PENSION-RATE-ADJで料率調整
      IF 合致 AND HEALTH-RATE-ADJ > 0
        HEALTH-RATE = DB2取得率 + HEALTH-RATE-ADJ
      IF 合致 AND PENSION-RATE-ADJ > 0
        PENSION-RATE = DB2取得率 + PENSION-RATE-ADJ
     2-2-5.保険料再計算（調整後）
     2-2-6.DEDUCTED-RESULTに出力（W01）
      TOTAL-PREMIUM = HEALTH-PREMIUM + PENSION-PREMIUM
  2-3.R01を読み込む。（1100R01INNSOR)(2件目以降）

3.終了処理（3000STPSOR）
  3-1.入出力ファイルのクローズ
  3-2.入出力件数出力メッセージ出力
    【入力メッセージ編集】
    メッセージ番号：6(入力件数メッセージ)
    PARM1：当該入力ファイルのDD名
    PARM2：当該入力ファイルの件数
    【出力メッセージ編集】
    メッセージ番号：7(出力件数メッセージ)
    PARM1：当該出力ファイルのDD名
    PARM2：当該出力ファイルの件数
  3-3.終了メッセージ出力
    【メッセージ編集】
    メッセージ番号：2(終了メッセージ)
```

---

## 出力レコード定義

### 出力ファイル1（W01/DEDUCTED-RESULT）

SHA06REC.cpyに従う。300B固定長。

| No | 項目名 | 設定元 | 備考 |
|----|--------|--------|------|
| 1 | EMP-ID | R01.EMP-ID | |
| 2 | EMP-NAME | R01.EMP-NAME | |
| 3 | INSURANCE-TYPE | R01.HEALTH-INS-TYPE | 健康保険種別 |
| 4 | GRADE-CODE | R01.GRADE-CODE | |
| 5 | MONTHLY-AMOUNT | R01.MONTHLY-AMOUNT | |
| 6 | HEALTH-RATE | DB2取得率(調整後) | 9(7) 小数点位置はプログラム内で規定 |
| 7 | PENSION-RATE | DB2取得率(調整後) | 9(7) 小数点位置はプログラム内で規定 |
| 8 | HEALTH-PREMIUM | 計算値 | MONTHLY-AMOUNT × HEALTH-RATE / 1000000 |
| 9 | PENSION-PREMIUM | 計算値 | MONTHLY-AMOUNT × PENSION-RATE / 1000000 |
| 10 | TOTAL-PREMIUM | 計算値 | HEALTH-PREMIUM + PENSION-PREMIUM |
| 11 | FILLER | 初期値 | |

### 出力ファイル2（W02/ERROR-LOG）

| No | 項目名 | 設定元 | 備考 |
|----|--------|--------|------|
| 1 | ERR-CATEGORY | 01で固定 | エラー種別（DBエラー／等級該当なし） |
| 2 | ERR-DETAIL | STRINGで編集 | エラー内容（EMP-ID + SQLCODE or 理由） |