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

詳細設計書

基本情報

#	項目	内容
1	システム名	社会保険管理システム
2	プログラムID	SHA04TWO
3	プログラム名	事業所保険者マッチング処理
4	PGMタイプ	メイン
5	PGMパターン	マッチング(1:1→1:1 2段階)
6	機能概要	被保険者データに対し、事業所マスタ(SHA02R02)と保険者マスタ(SHA03R03)の2段階1:1マッチングを実施する。
7		第1段階：事業所番号(OFFICE-NO)で事業所マスタとマッチング
8		第2段階：保険者コード(INSURER-CODE)で保険者マスタとマッチング
9		両段階ともマッチした場合GRADED-LISTに出力、いずれかで不一致の場合はUNMATCHED-LISTに出力

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

前提条件

NO	対象ファイル	条件
1	ファイルR01（INSURED-DATA）	事業所番号(OFFICE-NO)＋社員番号(EMP-ID)の昇順ソート済
2	ファイルR02（OFFICE-MST）	事業所番号(OFFICE-NO)の昇順ソート済、重複なし
3	ファイルR03（INSURER-MST）	保険者コード(INSURER-CODE)の昇順ソート済、重複なし

使用ファイル一覧

NO	使用ファイル/DB名	識別子	DD名	I/O	COPY群	形式	ブロック	レコード長	媒体	備考
1	INSURED-DATA	R01	SHA04R01	I	SHA01REC	FB		200	PS	被保険者データ（SHA01CVT出力）
2	OFFICE-MST	R02	SHA04R02	I	自前(80B)	FB		80	PS	事業所マスタ
3	INSURER-MST	R03	SHA04R03	I	自前(80B)	FB		80	PS	保険者マスタ
4	GRADED-LIST	W01	SHA04W01	O	SHA04REC	FB		200	PS	両段階マッチ成功レコード
5	UNMATCHED-LIST	W02	SHA04W02	O	自前(200B)	FB		200	PS	いずれかの段階で不一致レコード
6	ERROR-LOG	W03	SHA04W03	O	ZAN05REC	VB		200	PS	エラー退避
7	INSURANCEDB	DB	—	I	—	DB2	—	—	DASD	DB2: INSURED-MASTER

キー項目一覧

NO	ファイル名	ソート条件(キー項目)	キー条件(マッチング/キーブレイク)
1	ファイルR01	OFFICE-NO + EMP-ID	OFFICE-NO（第1段階）
2	ファイルR02	OFFICE-NO	OFFICE-NO（第1段階, 1:1）
3	ファイルR03	INSURER-CODE	INSURER-CODE（第2段階, 1:1）

使用モジュール一覧

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.R02（OFFICE-MST）を全件読み込み、内部テーブル(OFFICE-TBL)に格納する。
    (1110R02LDASOR)
  1-7.R03（INSURER-MST）を全件読み込み、内部テーブル(INSURER-TBL)に格納する。
    (1120R03LDASOR)
  1-8.DB接続
    EXEC SQL CONNECT TO 'data/INSURANCEDB.db'
  1-9.R01を読み込む。(1100R01INNSOR)(1回目)

2.主処理（2000MAJSOR)(R01を全て読み終えるまで下記を繰り返す）
  2-1.第1段階マッチング（OFFICE-NO vs OFFICE-TBL）：1:1マッチング（2010STG1SOR）
    2-1-1.OFFICE-TBLをOFFICE-NOで線形探索
    2-1-2.マッチ成功→第2段階へ
    2-1-3.マッチ失敗→UNMATCHED-LISTに出力（STATUS='1'=事業所未達）
  2-2.第2段階マッチング（INSURER-CODE vs INSURER-TBL）：1:1マッチング（2020STG2SOR）
    2-2-1.INSURER-TBLをINSURER-CODEで線形探索
    2-2-2.マッチ成功→GRADED-LISTに出力
    2-2-3.マッチ失敗→UNMATCHED-LISTに出力（STATUS='2'=保険者未達）
   2-3.DB2整合性検証（2030W01OUTSOR内でインライン実装）
     2-3-1.GRADED-LIST出力時にINSURED-MASTERをSELECTし、
          履歴整合性を確認
     2-3-2.SQLCODE異常→ERROR-LOGに出力
  2-4.R01を読み込む。（1100R01INNSOR)(2件目以降）

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

---

出力レコード定義

出力ファイル1（W01/GRADED-LIST）

SHA04REC.cpyに従う。200B固定長。

No	項目名	設定元	備考
1	EMP-ID	R01.EMP-ID
2	EMP-NAME	R01.EMP-NAME
3	OFFICE-NO	R01.OFFICE-NO
4	OFFICE-NAME	OFFICE-TBL.OFFICE-NAME	第1段階マッチ結果
5	PREF-CODE	OFFICE-TBL.PREF-CODE	第1段階マッチ結果
6	INSURER-CODE	R01.INSURER-CODE
7	INSURER-NAME	INSURER-TBL.INSURER-NAME	第2段階マッチ結果
8	FILLER	初期値

出力ファイル2（W02/UNMATCHED-LIST）

自前レイアウト（200B固定長）。

No	項目名	属性	設定元	備考
1	EMP-ID	9(8)	R01.EMP-ID
2	EMP-NAME	X(40)	R01.EMP-NAME
3	OFFICE-NO	X(4)	R01.OFFICE-NO
4	OFFICE-NAME	X(40)	OFFICE-TBL.OFFICE-NAME	未達時はSPACE
5	PREF-CODE	9(2)	OFFICE-TBL.PREF-CODE	未達時はZERO
6	INSURER-CODE	X(4)	R01.INSURER-CODE
7	INSURER-NAME	X(60)	INSURER-TBL.INSURER-NAME	未達時はSPACE
8	STATUS	X(1)	固定	'1'=事業所未達 / '2'=保険者未達
9	FILLER	X(41)	初期値

出力ファイル3（W03/ERROR-LOG）

No	項目名	設定元	備考
1	ERR-CATEGORY	01で固定	DBエラー
2	ERR-DETAIL	STRINGで編集	エラー内容（EMP-ID + SQLCODE）