Hitachi Multi Payment Network communications server for Biller

解説・手引書

3000-3-492-60

目　　次

前書き

変更内容

はじめに

1.　概要

1.1　MPNとは

1.1.1　MPNを利用した支払い方法

1.1.2　MPNが提供するサービス

1.2　MPNを構成する要素

1.3　収納機関と通信サーバ

1.3.1　収納機関が通信サーバを利用する形態

1.3.2　通信サーバの種類

1.4　通信サーバfor Billerの機能

1.4.1　システムの起動と停止

1.4.2　収納サービスの提供（電文の送受信）

1.4.3　システム運用

1.4.4　システム構築

1.5　通信サーバfor Billerの構成

1.5.1　通信サーバfor Billerのプロセス構造

1.5.2　通信サーバと共通ソフトウェアの通信形態

1.6　通信サーバfor Billerが送受信する電文

1.6.1　電文の構成

1.6.2　電文の流れ

1.6.3　電文を送受信するためのチェック機能

2.　システム構築の準備

2.1　システム構成の決定

2.2　MPNとの接続形態

2.3　システム構成の種類

2.3.1　HA構成の形態

2.3.2　クラスタ構成の形態

2.4　必要なソフトウェア

2.4.1　前提OS

2.4.2　前提ソフトウェア

2.4.3　ソフトウェア構成

2.5　システム構成例

2.5.1　HA構成の場合

2.5.2　クラスタ構成の場合

3.　システム構築の流れと環境設定

3.1　システム構築の流れ

3.2　通信サーバ管理者の設定

3.3　前提ソフトウェアの環境設定

3.4　通信サーバfor Billerのインストールと環境設定

3.4.1　インストール/環境設定する前に

3.4.2　通信サーバfor Billerのインストール

3.4.3　統合トレースの設定

3.4.4　通信サーバfor Billerの環境設定

3.4.5　ロウ論理ボリュームの作成

3.4.6　業務系SPPの格納

4.　システム定義

4.1　システム定義の概要

4.1.1　定義の構成と特長

4.1.2　システム構成の定義の特長

4.2　OpenTP1の定義

4.2.1　OpenTP1の定義の概要

4.2.2　OpenTP1の定義の手順

4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連

4.2.4　OpenTP1の定義項目

4.3　HiRDBの定義

4.3.1　HiRDBの定義の概要

4.3.2　HiRDBの定義の手順

4.3.3　HiRDBの定義項目

4.4　通信サーバシステム定義

4.4.1　通信サーバシステム定義の概要

4.4.2　通信サーバシステム定義の手順

4.4.3　通信サーバシステム定義ファイルの記述方法

4.4.4　通信サーバシステム定義の定義項目

4.4.5　通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権

4.5　HAモニタの定義

4.5.1　HAモニタの定義の概要

4.5.2　HAモニタの定義の手順

4.5.3　HAモニタの定義項目

4.5.4　LANの状態設定ファイルの作成

4.6　トレースの設定

4.6.1　トレースファイルの見積もり

4.6.2　トレースの出力レベルとしきい値

4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）

4.7.1　OpenTP1の定義の記述例

4.7.2　HiRDBの定義の記述例

4.7.3　通信サーバシステム定義の記述例

4.7.4　HAモニタの定義の記述例

4.7.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

4.8.1　OpenTP1の定義の記述例

4.8.2　HiRDBの定義の記述例

4.8.3　通信サーバシステム定義の記述例

4.8.4　HAモニタの定義の記述例

4.8.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

4.9　定義ファイルの記述例（クラスタ構成の場合）

4.9.1　OpenTP1の定義の記述例

4.9.2　通信サーバシステム定義の記述例

5.　DBへのテーブルの作成

5.1　DBに作成するテーブルの種類

5.2　電文履歴格納用テーブルの作成

5.2.1　作成手順

5.2.2　テーブルの形式

5.3　収納カウンタ情報格納用テーブルの作成

5.3.1　作成手順

5.3.2　テーブルの形式

5.4　納付情報格納用テーブルの作成

5.4.1　作成手順

5.4.2　テーブルの形式

5.5　請求情報格納用テーブルの作成

5.5.1　作成手順

5.5.2　テーブルの形式

5.6　消込情報格納用テーブルの作成

5.6.1　作成手順

5.6.2　テーブルの形式

5.7　対象金融機関情報格納用テーブルの作成

5.7.1　作成手順

5.7.2　テーブルの形式

5.8　対象収納機関情報格納用テーブルの作成

5.8.1　作成手順

5.8.2　テーブルの形式

5.9　障害情報格納用テーブルの作成

5.9.1　作成手順

5.9.2　テーブルの形式

5.10　状態管理情報格納用テーブルの作成

5.10.1　作成手順

5.10.2　テーブルの形式

5.11　国庫金納付情報格納用テーブルの作成

5.11.1　作成手順

5.11.2　テーブルの形式

5.12　国庫金消込情報格納用テーブルの作成

5.12.1　作成手順

5.12.2　テーブルの形式

5.13　国庫金対象金融機関情報格納用テーブルの作成

5.13.1　作成手順

5.13.2　テーブルの形式

6.　ユーザーコールバックの作成

6.1　ユーザーコールバックの役割

6.2　ユーザーコールバックが呼び出されるタイミング

6.3　サンプルファイル使用時のデータ解析方法

6.4　作成手順

6.4.1　作成時の注意

6.4.2　作成方法

6.5　ユーザーコールバックインターフェース

6.5.1　ユーザーコールバックインターフェース（地方税・地公体料金用）

6.5.2　ユーザーコールバックインターフェース（一般料金用）

6.5.3　ユーザーコールバックインターフェース（国庫金用）

7.　通信サーバfor Billerのインターフェース

7.1　業務系プロセスインターフェース

7.1.1　照会SPP用インターフェース

7.1.2　消込SPP用インターフェース（地方税・地公体料金，一般料金の場合）

7.1.3　消込SPP用インターフェース（国庫金の場合）

7.1.4　取消SPP用インターフェース

7.1.5　再送確認SPP用インターフェース（地方税・地公体料金，一般料金の場合）

7.1.6　再送確認SPP用インターフェース（国庫金の場合）

7.1.7　省略形式の電文

7.2　電文保証ポリシー

7.2.1　電文保証の概要

7.2.2　通信サーバfor Billerが保証する電文項目

7.2.3　レスポンスコード

7.3　収納業務受付インターフェース

7.3.1　電文履歴の照会用インターフェース

7.3.2　収納カウンタ情報の照会用インターフェース

7.3.3　納付情報の登録用インターフェース

7.3.4　納付情報の更新用インターフェース

7.3.5　納付情報の照会用インターフェース

7.3.6　納付情報の取消用インターフェース

7.3.7　請求情報の登録用インターフェース

7.3.8　請求情報の更新用インターフェース

7.3.9　請求情報の照会用インターフェース

7.3.10　請求情報の取消用インターフェース

7.3.11　消込情報の照会用インターフェース

7.3.12　取消情報の照会用インターフェース

7.4　エラー検出時収納業務プログラム呼び出し機能

7.5　納付区分エラー変換機能

8.　システム運用

8.1　システム運用の流れ

8.2　システムの起動と停止

8.2.1　システムを起動/停止する前に

8.2.2　通信サーバfor Billerの起動

8.2.3　収納機関サービスの起動

8.2.4　通信サーバfor Billerの開局

8.2.5　収納機関サービスの停止

8.2.6　通信サーバfor Billerの閉局

8.2.7　通信サーバfor Billerの停止

8.2.8　HA構成の場合の起動と停止

8.2.9　クラスタ構成の場合の起動と停止

8.3　システムの管理

8.3.1　状態表示

8.3.2　収納カウンタ情報取得

8.3.3　ファイル初期化

8.4　DBバッチ処理の運用

8.4.1　DBバッチ処理の運用手順

8.4.2　納付情報の一括登録

8.4.3　請求情報の一括登録

8.4.4　消込情報ファイルの変換

8.4.5　一括消込

8.4.6　消込情報の出力

8.4.7　金融機関情報の変更

8.4.8　収納機関情報の変更

9.　障害時の運用

9.1　障害情報の取得

9.1.1　ファイルに出力される障害情報

9.1.2　環境変数の設定内容

9.1.3　DBのテーブルに出力される障害情報

9.2　通信サーバfor Billerの障害対策

9.2.1　プロセス監視機能の概要

9.2.2　各プロセスの障害と対処

9.2.3　共通ソフトウェアのチャネルの障害

10.　コマンドリファレンス

10.1　コマンドを実行する前に

10.1.1　コマンドを実行できるユーザー

10.1.2　コマンド実行時の注意

10.2　コマンド一覧

10.3　コマンドの詳細

hmpnstart（通信サーバfor Billerの起動）

hmpnstop（通信サーバfor Billerの停止）

hmpnsvopen（収納機関サービスの起動）

hmpnsvclose（収納機関サービスの停止）

hmpnopen（開局）

hmpnclose（閉局）

hmpnstat（状態表示）

hmpncntget（収納カウンタ情報取得）

hmpnbilload（納付情報の一括登録）

hmpndemload（請求情報の一括登録）

hmpnpayfile（消込情報ファイルの変換）

hmpnpayload（一括消込）

hmpnpaylist（消込情報の出力）

hmpnbnkctl（金融機関情報の変更）

hmpnrcvctl（収納機関情報の変更）

hmpnblinit（ファイル初期化）

hmpnsetup（セットアップ）

付録

付録A　HiRDBのRDエリアの見積もり方法

付録A.1　電文履歴を格納するためのユーザー用RDエリアの算出方法

付録A.2　収納カウンタ情報を格納するためのユーザー用RDエリアの算出方法

付録A.3　納付情報を格納するためのユーザー用RDエリアの算出方法

付録A.4　請求情報を格納するためのユーザー用RDエリアの算出方法

付録A.5　消込情報を格納するためのユーザー用RDエリアの算出方法

付録A.6　金融機関情報を格納するためのユーザー用RDエリアの算出方法

付録A.7　収納機関情報を格納するためのユーザー用RDエリアの算出方法

付録A.8　不正電文情報を格納するためのユーザー用RDエリアの算出方法

付録A.9　状態管理情報を格納するためのユーザー用RDエリアの算出方法

付録B　制御ヘッダー部のフォーマット

付録C　消込処理でのエラー内容

付録D　DB Utility for Biller

付録D.1　DB Utility for Billerの概要

付録D.2　DB Utility for Billerのインストールと環境設定

付録D.3　システム定義（DB Utility for Biller）

付録D.4　DBへのテーブルの作成（DB Utility for Biller）

付録D.5　ユーザーコールバックインターフェース（DB Utility for Biller）

付録D.6　システム運用（DB Utility for Biller）

付録D.7　コマンドリファレンス（DB Utility for Biller）

付録E　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.

前書き

■ 対象製品

P-1B43-6311　 Hitachi Multi Payment Network communications server for Biller　 01-03(適用OS：HP-UX 11.0，HP-UX 11i)
P-1B43-6411　 Hitachi Multi Payment Network Database Utility for Biller　 01-01(適用OS：HP-UX 11.0，HP-UX 11i)
P-1M43-6311　 Hitachi Multi Payment Network communications server for Biller　 01-05(適用OS：AIX 5L Version 5.1，AIX 5L Version 5.2，AIX 5L Version 5.3)
P-1M43-6411　 Hitachi Multi Payment Network Database Utility for Biller　 01-02(適用OS：AIX 5L Version 5.1，AIX 5L Version 5.2，AIX 5L Version 5.3)

■ 輸出時の注意

本製品を輸出される場合には，外国為替および外国貿易法ならびに米国の輸出管理関連法規などの規制をご確認の上，必要な手続きをお取りください。
なお，ご不明な場合は，弊社担当営業にお問い合わせください。

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
ORACLEは，米国Oracle Corporation の登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
XATMIは，X/Open Company Limitedが開発したアプリケーションインタフェースの名称です。
マルチペイメントネットワーク共通ソフトウェアの著作権は株式会社NTTデータに帰属します。

■ 発行

2003年 5月（第1版）3000-3-492
2007年 9月（第7版）3000-3-492-60

■ 著作権

All Rights Reserved. Copyright (C) 2003, 2007, Hitachi, Ltd.

変更内容

変更内容（3000-3-492-60）Hitachi Multi Payment Network communications server for Biller 01-05（適用OS：AIX 5L），Hitachi Multi Payment Network Database Utility for Biller 01-02（適用OS：AIX 5L）

追加・変更内容 | 変更個所
OpenTP1 Version 7に対応しました。 | －
HiRDB Version 8に対応しました。 | －
国庫金収納サービスに対応しました。 | 1.6.2，1.6.3，4.2.1，4.2.4，4.4.1，4.4.4，5.1，5.2，5.11，5.12，5.13，6.3，6.4.1，6.4.2，6.5，6.5.3，7.1，7.1.1，7.1.3，7.1.4，7.1.6，7.1.7，7.2.1，7.2.2，7.2.3，7.3，7.3.1，7.3.11，10.2，10.3　hmpnbnkctl，付録A.1，付録A.3，付録A.5，付録A.6，付録A.8，付録B，付録C，付録D.4，付録D.7
HiRDB/Parallel Serverに対応しました。 | 2.4.2，2.4.3，3.2，8.4.1，9.1.1，10.3　hmpnbilload，10.3　hmpndemload，10.3　hmpnpayload，10.3　hmpnbnkctl，10.3　hmpnrcvctl，付録D.1，付録D.2
エラーが発生して仮消込として処理した場合に，収納業務プログラムに対してエラーの発生を通知する機能を追加しました。 | 4.4.4，7.4
収納情報の照会で3桁未満の納付区分を受信した場合に，レスポンスコードを変換する機能を追加しました。 | 4.4.4，7.5
一括消込コマンド「hmpnpayload」に，オプション「-a」「-is」「-iw」「-sw」「-sb」を追加しました。 | 10.3　hmpnpayload

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3000-3-492-50）Hitachi Multi Payment Network communications server for Biller 01-04（適用OS：AIX 5L），Hitachi Multi Payment Network Database Utility for Biller 01-01（適用OS：AIX 5L），Hitachi Multi Payment Network communications server for Biller 01-03（適用OS：HP-UX）

追加・変更内容

前提OSに，AIX 5L Version 5.3を追加しました。

消込情報ファイルの変換コマンド「hmpnpayfile」を複数同時実行できるようになりました。

収納機関サービスの起動コマンド「hmpnsvopen」および収納機関サービスの停止コマンド「hmpnsvclose」を収納機関単位に同時実行できるようになりました。

開局コマンド「hmpnopen」，閉局コマンド「hmpnclose」および収納カウンタ情報取得コマンド「hmpncntget」実行中に，収納機関サービスの起動コマンド「hmpnsvopen」および収納機関サービスの停止コマンド「hmpnsvclose」を実行できるようになりました。

仮消込情報として通信サーバfor Billerが設定するリターンコードに，「HMPN9001」および「HMPNA101」を追加しました。

変更内容（3000-3-492-40）Hitachi Multi Payment Network communications server for Biller 01-04（適用OS：AIX 5L），Hitachi Multi Payment Network communications server for Biller 01-03（適用OS：HP-UX）

追加・変更内容

すべての店舗が収納委託契約の金融機関に対して，仮想の店舗コードを指定できるようになりました。

一般料金の場合に，請求情報として格納する項目を追加しました。

消込情報ファイルの変換コマンド「hmpnpayfile」，および消込情報の出力コマンド「hmpnpaylist」の実行できるタイミングを変更しました。

変更内容（3000-3-492-30）Hitachi Multi Payment Network communications server for Biller 01-02（適用OS：AIX 5L，HP-UX）

追加・変更内容

前提OSに，AIX 5Lを追加しました。

前提ソフトウェアに，HiRDB Advanced High Availabilityを追加しました。

消込情報ファイルの変換コマンド「hmpnpayfile」にオプション「-dat」を追加しました。

はじめに

このマニュアルは，次に示すプログラムプロダクトの機能，システム構築方法，および運用方法について説明したものです。

P-1B43-6311　Hitachi Multi Payment Network communications server for Biller

P-1B43-6411　Hitachi Multi Payment Network Database Utility for Biller

P-1M43-6311　Hitachi Multi Payment Network communications server for Biller

P-1M43-6411　Hitachi Multi Payment Network Database Utility for Biller

なお，このマニュアルではHitachi Multi Payment Network communications server for Billerを通信サーバfor Biller，Hitachi Multi Payment Network Database Utility for BillerをDB Utility for Biller，またMulti Payment NetworkをMPNと表記します。

対象読者

このマニュアルは，収納機関でMPNを利用したシステムを構築・運用する方を対象としています。

次の知識があることを前提としています。

MPNの共通仕様に関する知識

共通ソフトウェアの構築と運用に関する知識

AIX 5LまたはHP-UX運用に関する基本的な知識

OpenTP1を使ったシステムの構築と運用に関する知識

HiRDBの構築と運用に関する知識

HAモニタを使ったシステムの構築と運用に関する知識（HA構成で構築する場合にだけ必要）

C言語，またはC++言語でコーディングするための知識

また，このマニュアルは，マニュアル「Hitachi Multi Payment Network communications server Base」の知識もあることを前提としていますので，あらかじめお読みいただくことをお勧めします。

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　概要

MPNおよび通信サーバfor Billerの概要について説明しています。

第2章　システム構築の準備

通信サーバfor Billerのシステムを構築する前に必要な準備について説明しています。

第3章　システム構築の流れと環境設定

通信サーバfor Billerのシステム構築の流れ，通信サーバ管理者の設定，および各ソフトウェアの環境設定について説明しています。

第4章　システム定義

OpenTP1の定義，HiRDBの定義，通信サーバシステム定義，HAモニタの定義，および通信サーバシステム定義に必要なトレースの設定について説明しています。

第5章　DBへのテーブルの作成

HiRDBにテーブルを作成する方法について説明しています。

第6章　ユーザーコールバックの作成

ユーザーコールバックの役割，作成手順などについて説明しています。

第7章　通信サーバfor Billerのインターフェース

通信サーバfor Billerのインターフェースについて説明しています。

第8章　システム運用

通信サーバfor Billerのシステムの起動/停止，システムの管理，およびDBバッチ処理の運用方法について説明しています。

第9章　障害時の運用

障害時に取得する情報，障害時の対応方法などについて説明しています。

第10章　コマンドリファレンス

コマンドを実行できるユーザー，実行時の注意，使用方法，書式などについて説明しています。

付録A　HiRDBのRDエリアの見積もり方法

HiRDBを利用する場合に必要な格納先RDエリアの算出方法について説明しています。

付録B　制御ヘッダー部のフォーマット

収納業務プログラムとの間で送受信する電文に追加される制御ヘッダー部のフォーマットについて説明しています。

付録C　消込処理でのエラー内容

消込処理で発生するおそれがあるエラー内容について説明しています。

付録D　DB Utility for Biller

DBバッチ処理機能を提供するための，DB Utility for Billerについて説明しています。

付録E　用語解説

このマニュアルで使用している用語の意味を説明しています。

関連マニュアル

このマニュアルに関連するマニュアルを次に示します。必要に応じてお読みください。

Hitachi Multi Payment Network communications server 概説（3000-3-493）

Hitachi Multi Payment Network communications server Base（3000-3-490）

Hitachi Multi Payment Network communications server メッセージ（3000-3-495）

Hitachi Multi Payment Network Extensible Database Option for Biller（3000-3-496）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 解説（3000-3-360）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成の手引（3000-3-361）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 システム定義（3000-3-362）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-363）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 クライアント使用の手引（3000-3-364）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編（3000-3-365）

OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 メッセージ（3000-3-368）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 解説（3000-3-941）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 プログラム作成の手引（3000-3-942）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 システム定義（3000-3-943）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-944）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編（3000-3-945）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 メッセージ（3000-3-947）

OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編（3000-3-949）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 解説（3000-3-D50）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成の手引（3000-3-D51）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 システム定義（3000-3-D52）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 運用と操作（3000-3-D53）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編（3000-3-D54）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 メッセージ（3000-3-D56）

OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編（3000-3-D58）

スケーラブルデータベースサーバ HiRDB Version 6 解説（UNIX(R)用）（3000-6-231）

スケーラブルデータベースサーバ HiRDB Version 6 システム導入・設計ガイド（UNIX(R)用）（3000-6-232）

スケーラブルデータベースサーバ HiRDB Version 6 システム定義（UNIX(R)用）（3000-6-233）

スケーラブルデータベースサーバ HiRDB Version 6 システム運用ガイド（UNIX(R)用）（3000-6-234）

スケーラブルデータベースサーバ HiRDB Version 6 コマンドリファレンス（UNIX(R)用）（3000-6-235）

スケーラブルデータベースサーバ HiRDB Version 6 UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-236）

スケーラブルデータベースサーバ HiRDB Version 6 SQLリファレンス（UNIX(R)/Windows(R)用）（3000-6-237）

スケーラブルデータベースサーバ HiRDB Version 6 メッセージ（UNIX(R)/Windows(R)用）（3000-6-238）

スケーラブルデータベースサーバ HiRDB Version 7 解説（UNIX(R)用）（3000-6-271）

スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）（3000-6-272）

スケーラブルデータベースサーバ HiRDB Version 7 システム定義（UNIX(R)用）（3000-6-273）

スケーラブルデータベースサーバ HiRDB Version 7 システム運用ガイド（UNIX(R)用）（3000-6-274）

スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）（3000-6-275）

スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）（3000-6-276）

スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（UNIX(R)/Windows(R)用）（3000-6-277）

スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（UNIX(R)/Windows(R)用）（3000-6-278）

スケーラブルデータベースサーバ HiRDB Version 8 解説（UNIX(R)用）（3000-6-351）

スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）（3000-6-352）

スケーラブルデータベースサーバ HiRDB Version 8 システム定義（UNIX(R)用）（3000-6-353）

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用）（3000-6-354）

スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）（3000-6-355）

スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド（3020-6-356）

スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス（3020-6-357）

スケーラブルデータベースサーバ HiRDB Version 8 メッセージ（3020-6-358）

高信頼化システム監視機能 HAモニタ（3000-9-109）

高信頼化システム監視機能 HAモニタ AIX(R)編（3000-9-130）

高信頼化システム監視機能 HAモニタ HP-UX編（3000-9-131）

高信頼化システム監視機能 HAモニタ メッセージ（3000-9-134）

なお，このマニュアルでは，次のマニュアルを省略して表記しています。マニュアルの正式名称と，このマニュアルでの表記を次に示します。

マニュアル名称 | このマニュアルでの表記
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 解説 | 分散トランザクション処理機能 OpenTP1 解説
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 解説
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 解説
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成の手引 | 分散トランザクション処理機能 OpenTP1 プログラム作成の手引
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 プログラム作成の手引
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成の手引
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 システム定義 | 分散トランザクション処理機能 OpenTP1 システム定義
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 システム定義
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 システム定義
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 運用と操作 | 分散トランザクション処理機能 OpenTP1 運用と操作
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 運用と操作
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 運用と操作
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 | 分散トランザクション処理機能 OpenTP1 クライアント使用の手引
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 クライアント使用の手引 TP1/Client/W，TP1/Client/P編
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編 | 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 プログラム作成リファレンス C言語編
OpenTP1 Version 5 分散トランザクション処理機能 OpenTP1 メッセージ | 分散トランザクション処理機能 OpenTP1 メッセージ
OpenTP1 Version 6 分散トランザクション処理機能 OpenTP1 メッセージ
OpenTP1 Version 7 分散トランザクション処理機能 OpenTP1 メッセージ
スケーラブルデータベースサーバ HiRDB Version 6 解説（UNIX(R)用） | スケーラブルデータベースサーバ HiRDB 解説
スケーラブルデータベースサーバ HiRDB Version 7 解説（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 解説（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 6 システム導入・設計ガイド（UNIX(R)用） | スケーラブルデータベースサーバ HiRDB システム導入・設計ガイド
スケーラブルデータベースサーバ HiRDB Version 7 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 システム導入・設計ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 6 システム定義（UNIX(R)用） | スケーラブルデータベースサーバ HiRDB システム定義
スケーラブルデータベースサーバ HiRDB Version 7 システム定義（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 システム定義（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 6 システム運用ガイド（UNIX(R)用） | スケーラブルデータベースサーバ HiRDB システム運用ガイド
スケーラブルデータベースサーバ HiRDB Version 7 システム運用ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 6 コマンドリファレンス（UNIX(R)用） | スケーラブルデータベースサーバ HiRDB コマンドリファレンス
スケーラブルデータベースサーバ HiRDB Version 7 コマンドリファレンス（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 コマンドリファレンス（UNIX(R)用）
スケーラブルデータベースサーバ HiRDB Version 6 UAP開発ガイド（UNIX(R)/Windows(R)用） | スケーラブルデータベースサーバ HiRDB UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 7 UAP開発ガイド（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド
スケーラブルデータベースサーバ HiRDB Version 6 SQLリファレンス（UNIX(R)/Windows(R)用） | スケーラブルデータベースサーバ HiRDB SQLリファレンス
スケーラブルデータベースサーバ HiRDB Version 7 SQLリファレンス（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス
スケーラブルデータベースサーバ HiRDB Version 6 メッセージ（UNIX(R)/Windows(R)用） | スケーラブルデータベースサーバ HiRDB メッセージ
スケーラブルデータベースサーバ HiRDB Version 7 メッセージ（UNIX(R)/Windows(R)用）
スケーラブルデータベースサーバ HiRDB Version 8 メッセージ
高信頼化システム監視機能 HAモニタ | 高信頼化システム監視機能 HAモニタ
高信頼化システム監視機能 HAモニタ AIX(R)編
高信頼化システム監視機能 HAモニタ HP-UX編

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別に次の流れに従ってお読みいただくことをお勧めします。

このマニュアルでの表記

このマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
AP | Application Program
API | Application Programming Interface
ATM | Auto Teller Machine
BES | Back End Server
CUP | Client User Program
DB | Data Base
FES | Front End Server
ftp | file transfer protocol
HA | High Availability
JAMMO | Japan Multi-Payment Network Management Organization
LAN | Local Area Network
MGR | System Manager
MPN | Multi Payment Network
MT | Magnetic Tape
OCR | Optical Character Reader
OS | Operating System
PC | Personal Computer
PP | Program Product
RPC | Remote Procedure Call
SPP | Service Providing Program
SQL | Structured Query Language
TCP/IP | Transmission Control Protocol/Internet Protocol
UAP | User Application Program
WS | Work Station

このマニュアルでは，製品名称および名称について次のように表記しています。ただし，それぞれの製品についての表記が必要な場合は，そのまま表記しています。

製品名称 | このマニュアルでの表記
Advanced Interactive eXecutive 5L Version 5.1 | AIX 5L
Advanced Interactive eXecutive 5L Version 5.2
Advanced Interactive eXecutive 5L Version 5.3
HiRDB Advanced High Availability Version 7 | HiRDB Advanced High Availability | HiRDB
HiRDB Advanced High Availability Version 8
HiRDB High Availability | －
HiRDB/Parallel Server Version 8 | HiRDB/Parallel Server
HiRDB/Run Time Version 6 | HiRDB/Run Time
HiRDB/Run Time Version 7
HiRDB/Run Time Version 8
HiRDB/Single Server Version 6 | HiRDB/Single Server
HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
Hitachi Multi Payment Network communications server Base | 通信サーバBase
Hitachi Multi Payment Network communications server for Bank | 通信サーバfor Bank
Hitachi Multi Payment Network communications server for Biller | 通信サーバfor Biller
Hitachi Multi Payment Network Database Utility for Biller | DB Utility for Biller
Hitachi Multi Payment Network Extensible Database Option for Biller | DB Option for Biller
HP-UX 11.0 | HP-UX
HP-UX 11i
Oracle9i Database Enterprise Edition | ORACLE
Oracle9i Database Standard Edition
TP1/Client/W | TP1/Client/W | OpenTP1
uCosminexus TP1/Client/W
TP1/Extension 1 | TP1/Extension 1
uCosminexus TP1/Extension 1
TP1/High Availability | TP1/High Availability
uCosminexus TP1/High Availability
TP1/Server Base | TP1/Server Base
uCosminexus TP1/Server Base
マルチペイメントネットワーク共通ソフトウェア | 共通ソフトウェア

（凡例）

－：該当しない

次のソフトウェアを通信サーバと表記しています。

通信サーバBaseと通信サーバfor Bankの組み合わせ

通信サーバBaseと通信サーバfor Billerの組み合わせ

また，このマニュアルでは，JAMMO（日本マルチペイメントネットワーク運営機構）での呼称を，次のように表記しています。JAMMOでは，一般料金の場合の「請求情報」と，地方税・地公体料金および国庫金の場合の「納付情報」を総称して「請求情報」と呼びます。このマニュアルでは，「収納情報」が総称となります。

JAMMOでの呼称 | このマニュアルでの表記
請求情報 | 請求情報（一般料金の場合） | 収納情報 | 請求情報（一般料金の場合）
納付情報（地方税・地公体料金および国庫金の場合） | 納付情報（地方税・地公体料金および国庫金の場合）

このマニュアルで使用する文法記号

このマニュアルで使用している文法記述記号を次に示します。

文法記述記号
意味

［　］
この記号で囲まれている項目は省略できることを示します。

（例）　［A］

「何も指定しない」か「Aを指定する」ことを示します。

｛　｝
この記号で囲まれている項目のうち一つを選択することを示します。

（例）　{Y|N}

「Y」または「N」を選択することを示します。

|
選択する項目の区切りを示します。

（例）　{Y|N}

「Y」または「N」を選択することを示します。

～
この記号の前に示された項目が，記号～に続く<　>，((　))などの規則に従わなければならないことを示します。

<　>
または
《　》
ユーザー指定値の構文要素を示します。

（例）　<パス名>

パス名を指定することを示します。

((　))
ユーザー指定値の指定範囲を示します。

（例）　((0～16))

0から16の範囲で指定することを示します。

:
この記号と一緒にパス名が記載されている場合，パス名が連続していることを示します。

このマニュアルで使用している構文要素記号を次に示します。

構文要素記号 | 意味
<アルファベット> | A～Z，a～z
<英字> | アルファベットおよび「_」（アンダースコア）
<英数字> | 英字と数字の並びから成る文字列
<識別子> | 先頭にアルファベットを使用します。2文字目以降は，英数字を使用できます。
<パス名> | 英数字，#，「-」（ハイフン）※，「.」（ピリオド），「/」（スラント），@，¥
<符号なし整数> | 数字列（0～9）/
<文字列> | 任意の文字の配列

注※

先頭では使用できません。

なお，このマニュアルで，DBの入力情報ファイルの形式での属性を説明している場合は，次に示す構文要素記号を使用します。

構文要素記号 | 意味
《数字》 | 数字列（0～9）
《英字》 | アルファベット（A～Z）
《カナ文字》 | 半角カナ
《全角文字》 | 漢字を含む2バイト文字
《記号》 | 「(」，「)」（丸括弧），「,」（コンマ），「-」（ハイフン），「.」（ピリオド），「/」（スラント），「¥」
《カナ記号》 | 濁点，半濁点，「「」，「」」（かぎ括弧）

図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

個所（かしょ），桁（けた），汎用（はんよう），必須（ひっす），閉塞（へいそく）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　概要

この章では，MPNおよび通信サーバfor Billerの概要について説明します。

＜この章の構成＞

1.1　MPNとは

1.2　MPNを構成する要素

1.3　収納機関と通信サーバ

1.4　通信サーバfor Billerの機能

1.5　通信サーバfor Billerの構成

1.6　通信サーバfor Billerが送受信する電文

1.1　MPNとは

現在，公共料金や税金などの支払い方法には，金融機関の窓口での支払い，口座振替での支払いなどがあります。これらの支払い方法には，次のような問題があります。

金融機関および収納機関（企業，官公庁，地方公共団体など）側での問題

請求書や口座振替事前通知書などの紙を利用した処理であるため，金融機関および収納機関の事務負担，コスト負担が大きい。

利用者側での問題

支払い窓口の営業時間でなければ支払いができない。

支払い時に，窓口で待たなければならない。

このような問題を解決するために生まれたのが，MPNです。MPNを利用した支払い方法には，次のようなメリットがあります。

金融機関および収納機関側でのメリット

収納情報を電子データ化できるため，金融機関および収納機関は収納事務の効率化を図れる。

利用者側でのメリット

利用者は，PC，モバイル，電話，ATMなどの支払いチャネル（支払い手段）を利用して，自分に合った方法で，自分の好きな時間に支払いができる。

＜この節の構成＞

1.1.1　MPNを利用した支払い方法

1.1.2　MPNが提供するサービス

1.1.1　MPNを利用した支払い方法

MPNを利用した料金の支払い方法を次に示します。

図1-1　MPNを利用した料金の支払い方法

1.1.2　MPNが提供するサービス

MPNは，次のようなサービスを提供します。

請求情報通知サービス

サービスの利用申請をした利用者は，金融機関が提供する各種支払いチャネルを利用して，電子的に収納情報の照会ができます。また，照会後に，収納サービスを利用して料金を支払うこともできます。このサービスによって請求書が不要になるため，収納機関は，請求書の作成，送付などの事務負担を軽減できます。また，利用者は，窓口に請求書を持参しなくても，支払いができるようになります。

収納サービス

利用者は，収納機関からの収納情報を基に，金融機関が提供する各種支払いチャネルから支払いができます。その消込情報は，MPNを通じて，即時に収納機関に通知されます。このサービスによって，金融機関は，データの仕分け，収納通知などの事務負担を軽減できます。収納機関は，消込作業を自動化できます。また，利用者は，好きな時間に料金の支払いができるようになります。

収納サービスは，対象となる収納機関によって，次のように分類できます。

表1-1　収納サービスの分類

サービス名 | 対象となる収納機関
一般収納サービス | 民間企業
国庫金収納サービス | 官公庁
地公体収納サービス | 地方公共団体

また，各収納サービスは，次のサービスで構成されます。

照会サービス

消込サービス

取消サービス

口座振替受付サービス

口座振替の新規登録，口座変更，解約が，金融機関または収納機関が提供する各種支払いチャネルを利用して受付できます。それらの登録情報は，収納機関と金融機関との間で，電子データとしてやり取りされるため，金融機関および収納機関の事務負担を軽減できます。また，口座振替の申請にかかわる利用者の負担を軽減できます。

口座振替データ伝送サービス

口座振替依頼および口座振替結果のデータを，MPNを通じて，収納機関と金融機関の間でやり取りできます。電子データとしてやり取りできるため，MTの作成および搬送にかかわる収納機関の事務負担を軽減できます。また，口座の解約および変更が，口座振替直前でもできるようになります。

1.2　MPNを構成する要素

MPNの構成を次に示します。

図1-2　MPNの構成

MPNは，次のような要素から構成されます。

支払いチャネル

金融機関が，各業務メニューを利用者に提供します。

基幹システム

金融機関の基幹システムは，利用者の口座の管理や，支払いチャネルの制御をします。収納機関の基幹システムは，顧客情報の作成および管理をします。

通信サーバ

金融機関または収納機関の基幹システムが，MPNに接続するための機能を提供します。通信サーバの利用形態には，一つの金融機関または収納機関が単独で利用する形態と，複数の金融機関または収納機関が共同で利用する形態があります。

MPNセンタ

金融機関と収納機関を相互に接続し，金融機関と収納機関との間でやり取りされる電文の振り分けをします。

1.3　収納機関と通信サーバ

収納機関は，通信サーバを導入することで，MPNの収納サービスを提供できます。ここでは，収納機関が収納サービスを提供する形態，および通信サーバの種類について説明します。

＜この節の構成＞

1.3.1　収納機関が通信サーバを利用する形態

1.3.2　通信サーバの種類

1.3.1　収納機関が通信サーバを利用する形態

収納機関が通信サーバを利用する形態には，一つの収納機関が単独で通信サーバを利用する形態と，複数の収納機関が共同で通信サーバを利用する形態があります。

一つの収納機関が，単独で通信サーバを利用する形態を次に示します。

図1-3　収納機関と通信サーバ（通信サーバを単独で利用する場合）

複数の収納機関が，共同で通信サーバを利用する形態を次に示します。

図1-4　収納機関と通信サーバ（通信サーバを共同で利用する場合）

通信サーバを単独で利用する場合，共同で利用する場合に関係なく，通信サーバには次の定義があります。

収納機関に共通の定義

各収納機関専用の定義

各収納機関の収納サービスは，各収納機関専用の定義に従って動作するため，各収納機関で収納サービスを開始，または終了できます。

通信サーバに必要なシステム定義については，「4　システム定義」を参照してください。

1.3.2　通信サーバの種類

通信サーバを構成するソフトウェアには，次の種類があります。

通信サーバBase

通信サーバfor Biller使用時に必要な共通基盤機能，およびファイル転送機能を提供します。

通信サーバfor Biller

収納機関がMPNのサービスを提供するために必要なオンライン機能を提供します。

DB Utility for Biller

HiRDBを通信サーバfor Billerと別のマシンにセットアップした場合に，DBバッチ処理機能を提供するユティリティです。

DB Option for Biller

通信サーバfor Billerで使用するDBをORACLEとして構築・運用する場合に，必要なソフトウェアです。DBバッチ処理機能などを提供します。

収納機関がMPNのサービスを提供する場合は，通信サーバBase，および通信サーバfor Billerが必要です。このマニュアルでは，通信サーバBaseと通信サーバfor Billerを合わせて，通信サーバと呼びます。

なお，通信サーバfor Billerの前提ソフトウェアについては，「2.4　必要なソフトウェア」を参照してください。

1.4　通信サーバfor Billerの機能

通信サーバfor Billerは，収納機関がMPNのサービスを提供するために必要なソフトウェアです。通信サーバfor Billerを使用することによって，信頼性が高いMPNサービスを低コストで構築できます。

ここでは，通信サーバfor Billerの主な機能の概要について説明します。通信サーバfor Billerが提供する機能には，システムの起動と停止をする機能，収納サービスの提供をする機能，およびシステム運用に関する機能があります。通信サーバfor Billerの機能の構成を次に示します。

図1-5　機能の構成

次に，それぞれの機能について説明します。

＜この節の構成＞

1.4.1　システムの起動と停止

1.4.2　収納サービスの提供（電文の送受信）

1.4.3　システム運用

1.4.4　システム構築

1.4.1　システムの起動と停止

通信サーバfor Billerの機能のうち，システムの起動と停止に必要な機能について説明します。

＜この項の構成＞

(1)　通信サーバfor Billerの起動と停止

(2)　収納機関サービスの起動と停止

(3)　通信サーバfor Billerの開局と閉局

(1)　通信サーバfor Billerの起動と停止

OpenTP1や共通ソフトウェアと連動した起動/停止

分散トランザクション処理機能を提供するOpenTP1や共通ソフトウェアと連動して，通信サーバfor Billerを起動/停止します。

(2)　収納機関サービスの起動と停止

収納機関の収納サービスの起動/停止/予備閉局

収納機関の収納サービスを起動/停止します。通信サーバfor Billerと連動して起動することもできます。また，収納機関サービスの予備閉局機能を利用すると，指定した収納機関の収納情報の照会サービスだけを停止することもできます。

(3)　通信サーバfor Billerの開局と閉局

通信サーバfor Billerの開局/閉局

MPNセンタとのオンライン処理を開始/終了するために，通信サーバfor Billerの開局/閉局をします。通信サーバfor Billerおよび収納機関サービスの起動と連動して開局をすることもできます。

1.4.2　収納サービスの提供（電文の送受信）

通信サーバfor Billerの機能のうち，収納サービスを提供する機能について説明します。

収納情報の照会

金融機関の各種支払いチャネルを利用して，収納機関が保有する収納情報を照会します。

収納情報の消込

利用者が公共料金や税金などを金融機関に支払ったこと（収納情報）をDBに登録します。

収納情報の取消

消込済みの収納情報を消込前の状態（利用者が料金を支払う前の状態）に戻します。

収納情報の再送確認

収納情報が消込済みかどうかを確認します。消込済みでない場合には，再度DBに登録します。消込済みである場合には，何も処理を行いません。

1.4.3　システム運用

通信サーバfor Billerの機能のうち，システム運用に必要な機能について説明します。

＜この項の構成＞

(1)　オンライン中の運用

(2)　オフライン中の運用

(3)　障害時の運用

(1)　オンライン中の運用

通信サーバfor Billerがオンライン中に提供する機能には，次の機能があります。

収納情報の操作

収納サーバから要求された収納情報の登録，更新，照会，取消などのDBの操作をします。

収納カウンタ情報の取得

MPNセンタ上に保管されている収納カウンタ情報を取得します。収納カウンタ情報には，通信サーバfor BillerとMPNセンタとの間の収納情報の集計値が含まれており，オンライン取引の精査に使用できます。取得した収納カウンタ情報は，DBに保存されます。

電文履歴の保存

通信サーバfor BillerとMPNセンタとの間で送受信した電文を履歴としてDBに保存します。

データ解析

ユーザーコールバックインターフェースを使用すると，電文の情報を取り出すことができます。

状態表示

通信サーバfor Billerの構成の種類，起動状態，開閉局状態および収納機関ごとの収納機関サービスの状態を表示します。

プロセスの監視

通信サーバfor Billerに必要なプロセスの障害監視をします。監視対象は，通信サーバfor Biller，および共通ソフトウェアのプロセスです。

(2)　オフライン中の運用

通信サーバfor Billerがオフライン中に提供する機能には，次の機能があります。

なお，通信サーバfor BillerとHiRDBを別のマシンにセットアップした場合は，DB Utility for Billerを導入して次の機能を運用してください。

納付情報の一括登録

複数の納付情報を，通信サーバfor BillerのDBへ一括登録します。

請求情報の一括登録

複数の請求情報を，通信サーバfor BillerのDBへ一括登録します。

消込情報ファイルの変換

MPNセンタからファイル転送機能によって，通信サーバfor Billerに送られる伝送ファイルを消込情報ファイルに変換します。

一括消込

複数の消込情報を，通信サーバfor BillerのDBへ一括登録します。

消込情報の出力

通信サーバfor BillerのDBから該当する消込情報をファイルとして出力します。

金融機関情報の変更

通信サーバfor BillerのDBへの金融機関情報の追加登録や，DBの該当する金融機関情報の削除をします。

収納機関情報の変更

通信サーバfor BillerのDBへの収納機関情報の追加登録や，DBの収納機関情報の削除をします。

(3)　障害時の運用

通信サーバfor Billerには，障害が発生した場合に備えて，次の機能があります。

障害情報の取得

ファイルやテーブルを基に障害情報を取得します。障害発生時のトレース情報を，トレースファイルとして出力します。トレースの出力先には，syslog，統合トレース，およびプロセス別トレースがあります。

1.4.4　システム構築

通信サーバfor Billerには，システム構築に必要な次の機能があります。

定義チェック

通信サーバシステム定義の定義ファイルをチェックします。ファイルのフォーマットや定義値などをチェックできます。

1.5　通信サーバfor Billerの構成

ここでは，通信サーバfor Billerを構成するプロセス，および通信サーバfor Billerと共通ソフトウェアの通信形態について説明します。

＜この節の構成＞

1.5.1　通信サーバfor Billerのプロセス構造

1.5.2　通信サーバと共通ソフトウェアの通信形態

1.5.1　通信サーバfor Billerのプロセス構造

通信サーバfor Billerのプロセス構造を次に示します。

図1-6　プロセス構造

次に，各プロセスについて説明します。これ以外の機能は，コマンドとして提供しています。

表1-2　プロセスの概要

ソフトウェア | プロセス | 説明
通信サーバfor Biller | 制御系プロセス | プロセス監視デーモン | 共通ソフトウェア，および監視プロセスのプロセスダウンを検知します。
監視プロセス | OpenTP1監視プロセス | OpenTP1のダウンを検知します。
制御電文受信CUP監視プロセス | 制御電文受信CUPのダウンを検知します。
業務電文受信CUP監視プロセス | 業務電文受信CUPのダウンを検知します。
SPP障害監視プロセス | 業務系プロセス，および収納カウンタ取得SPPがダウンして再起動できない状態になったことを検知します。
制御電文受信CUP | MPNセンタから送信される制御電文を受信します。また，受信した電文種別に従って，開閉局を制御します。
収納カウンタ情報取得SPP | MPNセンタが保有する収納カウンタ情報を取得します。
業務系プロセス | 業務電文受信CUP | MPNセンタから送信される業務電文を受信します。また，受信した電文種別に該当するサービスを呼び出します。
収納業務受付SPP | 収納業務プログラムからの呼び出しで，DB内の各情報の登録，更新などを行います。
照会SPP | 各収納機関に対応した照会サービスに必要な電文をMPNセンタとの間で送受信します。照会サービスは，利用者から収納情報の照会依頼があったときに，収納機関で収納情報を照会し，MPNセンタを通して利用者にその収納情報を返信するサービスです。
消込SPP | 各収納機関に対応した消込サービスに必要な電文をMPNセンタとの間で送受信します。消込サービスは，利用者が料金，税金などを支払ったときに，その収納情報の消込依頼を収納機関で受け，消込結果を利用者に返信するサービスです。
再送確認SPP | MPNセンタに要求された収納情報が消込済みかどうかを判定し，消込済みでない場合に，消込情報をDBに書き込みます。
取消SPP | 各収納機関に対応した取消サービスに必要な電文をMPNセンタとの間で送受信します。取消サービスは，消込済みの収納情報を消込前の状態（料金を支払う前の状態）に戻すサービスです。
OpenTP1 | 通信サーバfor Billerの各プロセスの動作に必要な基盤機能を提供します。
共通ソフトウェア | MPNセンタとの間で，電文またはファイルの送受信をします。
HiRDB | 通信サーバfor BillerのDBです。通信サーバfor Billerの各プロセスで取得した情報や電文履歴などが格納されます。

1.5.2　通信サーバと共通ソフトウェアの通信形態

共通ソフトウェアは，通信サーバを使用する場合に必要となる通信ソフトウェアです。通信サーバがMPNセンタとの間で電文やファイルを送受信するときは，共通ソフトウェアが通信の制御をします。これによって，通信サーバは，伝送制御手順を意識することなく，MPNセンタと通信できます。

通信サーバfor BillerがMPNセンタと電文を送受信するときは，共通ソフトウェアのキューマネージャー（オンライン電文用）を使用します。また，通信サーバBaseがファイルを送受信するときは，共通ソフトウェアのキューマネージャー（ファイル転送用）を使用します。キューマネージャーは，MPNセンタとの間の通信路としてチャネルを持っています。

チャネルには送信チャネルと受信チャネルがあり，この二つで一つの系を構成しています。キューマネージャーは，MPNセンタとの間に，一つ以上の系のチャネルを持っている必要があります。

キューマネージャーとチャネルの構成例を次に示します。この図では，キューマネージャーは二つの系のチャネルを持っています。

図1-7　キューマネージャーとチャネルの構成例

1.6　通信サーバfor Billerが送受信する電文

通信サーバfor Billerが送受信する電文を次に示します。

制御電文

収納カウンタ情報電文

業務電文

収納業務受付インターフェースで送受信される電文

ここでは，制御電文，収納カウンタ情報電文，業務電文，および収納業務受付インターフェースで送受信される電文の構成と流れ，および電文を送受信するために提供する機能について説明します。

＜この節の構成＞

1.6.1　電文の構成

1.6.2　電文の流れ

1.6.3　電文を送受信するためのチェック機能

1.6.1　電文の構成

通信サーバfor Billerが送受信する電文の構成について説明します。

＜この項の構成＞

(1)　制御電文

(2)　収納カウンタ情報電文

(3)　業務電文

(4)　収納業務受付インターフェースで送受信される電文

(1)　制御電文

通信サーバfor Billerが開局する場合，閉局する場合などに送受信する電文です。制御電文は，MPN電文のヘッダー部だけで構成されています。MPN電文とは，MPNの仕様に基づいて作成された電文です。制御電文の構成を次に示します。

図1-8　制御電文の構成

制御電文の構成要素について，次に示します。

表1-3　制御電文の構成要素

制御電文の構成要素 | 内容
ヘッダー部 | 通信サーバfor BillerがMPNセンタとの接続を開始/終了させるのに必要な情報が設定されています。

(2)　収納カウンタ情報電文

収納カウンタ情報電文は，通信サーバfor BillerがMPNセンタから収納カウンタ情報を取得するために送受信する電文です。収納カウンタ情報は，収納サービスのオンライン取引の精査に利用します。

収納カウンタ情報電文は，通信サーバfor Billerの閉局時に，通信サーバfor BillerとMPNセンタとの間で送受信します。また，コマンドを実行して送受信することもできます。収納カウンタ情報電文は，ヘッダー部，ビットマップ部，およびデータ部から構成されるMPN電文です。

収納カウンタ情報電文の構成を次に示します。

図1-9　収納カウンタ情報電文の構成

収納カウンタ情報電文の構成要素について，次に示します。

表1-4　収納カウンタ情報電文の構成要素

収納カウンタ情報電文の
構成要素
内容

ヘッダー部
収納カウンタ情報を取得するために必要な情報が設定されています。

ビットマップ部
データ部のデータ項目の有無が設定されています。

データ部
収納カウンタ情報照会要求に対応するデータ項目が設定されています。
データ部の中のデータは，収納カウンタ情報電文の種類によって異なります。

(3)　業務電文

通信サーバfor Billerが，MPNセンタおよび収納業務プログラムとの間で送受信する電文です。通信サーバfor BillerとMPNセンタとの間で送受信する電文と，通信サーバfor Billerと収納業務プログラムとの間で送受信する電文は，電文の構成が異なります。通信サーバfor BillerとMPNセンタとの間で送受信する電文は，ヘッダー部，ビットマップ部，およびデータ部から構成されるMPN電文です。通信サーバfor Billerと収納業務プログラムとの間で送受信する電文には，MPN電文に加えて，制御ヘッダー部が追加されます。業務電文の構成を次に示します。

図1-10　業務電文の構成

業務電文の構成要素について次に示します。

表1-5　業務電文の構成要素

業務電文の構成要素
内容

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムとの間で電文を送受信するときにMPN電文に追加されます。MPNセンタの要求に対して通信サーバfor Biller，および収納業務プログラムが必要とする情報が設定されています。通信サーバfor BillerとMPNセンタとの間で送受信する電文には含まれません。

MPN電文
ヘッダー部
通信サーバfor BillerがMPNセンタ，および収納業務プログラムとの間で送受信する電文の種類を識別できる情報が設定されています。このヘッダー部の内容によって，通信サーバfor Billerの処理は変わります。

ビットマップ部
データ部のデータ項目の有無が設定されています。

データ部
MPNセンタからの照会，消込，取消などの要求に対応するデータ項目が設定されています。
データ部の中のデータは，業務電文の種類，および収納機関によって異なります。

(4)　収納業務受付インターフェースで送受信される電文

通信サーバfor Billerが，収納業務プログラムとの間で送受信する電文です。

収納業務受付インターフェースで送受信される電文の構成を次に示します。収納業務IDと，電文種別コードやお客様番号といった電文の中心となる情報から構成されます。情報の内容は，それぞれの収納業務受付インターフェースで異なります。

図1-11　収納業務受付インターフェースで送受信される電文の構成

収納業務受付インターフェースの詳細については，「7.3　収納業務受付インターフェース」を参照してください。

1.6.2　電文の流れ

通信サーバfor Billerが送受信する電文の流れについて説明します。

＜この項の構成＞

(1)　制御電文

(2)　収納カウンタ情報電文

(3)　業務電文

(4)　収納業務受付インターフェースで送受信される電文

(1)　制御電文

通信サーバfor BillerとMPNセンタとの間で電文を送受信します。

制御電文は，通信サーバfor Billerの開閉局処理で送受信される電文です。制御電文の種類を次に示します。

表1-6　制御電文の種類

開閉局処理
制御電文の種類

開局
開始要求電文
開始応答電文

閉局
終了要求電文
終了応答電文
終了準備要求電文
終了準備応答電文

コマンドを実行して開局する場合の電文の流れを次に示します。コマンドを実行して閉局する場合については，開始要求電文を終了要求電文に，開始応答電文を終了応答電文に，開局中を閉局中に読み替えてください。

図1-12　コマンドを実行して開局する場合の電文の流れ

MPNセンタから開局要求を受信して開局する場合の電文の流れを次に示します。

図1-13　MPNセンタから開局要求を受信して開局する場合の電文の流れ

また，MPNセンタから閉局要求を受信して閉局する場合の電文の流れを次に示します。

図1-14　MPNセンタから閉局要求を受信して閉局する場合の電文の流れ

(2)　収納カウンタ情報電文

MPNセンタと通信サーバfor Billerとの間で電文を送受信します。通信サーバfor Billerの閉局時に収納カウンタ情報を送受信する場合と，コマンドを実行して送受信する場合とでは，電文の流れは異なります。

通信サーバfor Billerの閉局時に収納カウンタ情報を送受信する場合の電文の流れを，次に示します。ここで示すカウンタ通知電文およびカウンタ応答電文が，収納カウンタ情報電文です。

図1-15　通信サーバfor Billerの閉局時に収納カウンタ情報を送受信する場合の電文の流れ

コマンドを実行して収納カウンタ情報を送受信する場合の電文の流れを，次に示します。ここで示すカウンタ照会依頼電文およびカウンタ照会応答電文が，収納カウンタ情報電文です。

図1-16　コマンドを実行して収納カウンタ情報を送受信する場合の電文の流れ

(3)　業務電文

収納情報の照会，消込，取消などの処理は，通信サーバfor BillerとMPNセンタ，および通信サーバfor Billerと収納業務プログラムとの間で電文を送受信して行われます。

業務電文は，収納情報の照会，消込，取消などの処理で送受信される電文です。業務電文の電文名は，収納情報の操作や収納サービスの種類によって異なります。業務電文の種類を次に示します。

表1-7　業務電文の種類

収納情報の操作
収納サービスの種類
業務電文の種類

照会
地方税・地公体料金，一般料金，国庫金
照会依頼電文
照会応答電文
照会エラー応答電文

取消
地方税・地公体料金，一般料金
取消依頼電文
取消応答電文
取消エラー応答電文

国庫金
国庫金取消依頼電文
国庫金取消応答電文
国庫金取消エラー応答電文

消込
地方税・地公体料金，一般料金
消込依頼電文
消込応答電文
消込エラー応答電文

国庫金
国庫金消込依頼電文
国庫金消込応答電文
国庫金消込エラー応答電文

再送確認
地方税・地公体料金，一般料金
再送確認通知電文
再送確認応答電文
再送確認通知エラー応答電文

国庫金
国庫金再送確認通知電文
国庫金再送確認応答電文
国庫金再送確認通知エラー応答電文

収納情報を照会する場合および取消する場合の電文の流れを，収納情報を照会する場合を例に，次に示します。収納情報を取消する場合については，照会依頼電文を取消依頼電文に，照会応答電文を取消応答電文に読み替えてください。また，国庫金の場合には，国庫金用の電文名に読み替えてください。

図1-17　収納情報を照会する場合の電文の流れ

地方税・地公体料金，一般料金の収納情報を消込する場合および再送確認する場合の電文の流れを，収納情報を消込する場合を例に，次に示します。収納情報を再送確認する場合については，消込依頼電文を再送確認通知電文に，消込応答電文を再送確認応答電文に読み替えてください。

図1-18　収納情報を消込する場合の電文の流れ（地方税・地公体料金，一般料金の場合）

国庫金の収納情報を消込する場合および再送確認する場合の電文の流れを，収納情報を消込する場合を例に，次に示します。収納情報を再送確認する場合については，国庫金消込依頼電文を国庫金再送確認通知電文に，国庫金消込応答電文を国庫金再送確認応答電文に読み替えてください。

図1-19　収納情報を消込する場合の電文の流れ（国庫金の場合）

(4)　収納業務受付インターフェースで送受信される電文

通信サーバfor Billerが，収納業務プログラムとの間で電文を送受信します。

収納業務受付インターフェースで送受信される電文の流れを，次に示します。

図1-20　収納業務受付インターフェースで送受信される電文の流れ

1.6.3　電文を送受信するためのチェック機能

通信サーバfor Billerは，MPNセンタ，および収納業務プログラムとの電文の送受信時に，次に示すチェック機能を提供しています。

対象金融機関チェック

不正電文チェック

なお，電文の送受信をスムーズにするために，これらのチェック機能に加えて通信サーバfor Billerでは電文を保証します。詳細については，「7.2　電文保証ポリシー」を参照してください。

＜この項の構成＞

(1)　対象金融機関チェック

(2)　不正電文チェック

(1)　対象金融機関チェック

通信サーバfor Billerは対象となっている金融機関情報についてチェックしています。チェックするタイミングを次に示します。

図1-21　対象金融機関チェックのタイミング（照会依頼電文の場合）

このチェックでは，通信サーバfor Billerが受信した電文の次の項目についてDBの対象金融機関情報格納用テーブルの内容と一致しているかどうかをチェックしています。

地方税・地公体料金の場合

ヘッダー部の「金融機関コード」，および「店舗コード」

データ部の「チャネル区分」

データ部の「納付区分」にある「税目・料金番号」

一般料金の場合

ヘッダー部の「金融機関コード」，および「店舗コード」

データ部の「チャネル区分」

国庫金の場合

ヘッダー部の「歳入代理店金融機関コード」，および「店舗コード」

データ部の「チャネル区分」

データ部の「納付区分」（収納機関コードが国税庁（00200000）の場合だけ）

このチェックを対象金融機関チェックと呼びます。なお，ヘッダー部の「店舗コード」が「仮想店舗コード」の場合，通常，店舗単位でのチェックではなく，金融機関単位でのチェックをします。このように，対象金融機関の収納委託契約状況に合わせて電文をチェックできます。対象金融機関チェックの結果はレスポンスコードとして設定されます。

(2)　不正電文チェック

正しい電文かどうかをチェックし，取得できない不正電文情報である場合は，DBの障害情報格納用テーブルに格納されます。

受信した電文をチェックし，不正電文を取得するタイミングを次に示します。

図1-22　不正電文チェックのタイミング（照会依頼電文の場合）

不正電文情報からの障害情報の取得方法については，「9.1.3　DBのテーブルに出力される障害情報」を参照してください。

2.　システム構築の準備

この章では，通信サーバfor Billerを構築する前の準備として必要な前提条件およびシステム構成例について説明します。

＜この章の構成＞

2.1　システム構成の決定

2.2　MPNとの接続形態

2.3　システム構成の種類

2.4　必要なソフトウェア

2.5　システム構成例

2.1　システム構成の決定

どのようなシステム構成にするかを決定します。

MPNは多数の機関が参加するネットワークシステムのため，1機関でもシステムが停止すると，システム全体に大きな影響を及ぼすおそれがあります。

そのため，収納機関での通信サーバのシステム構成では，信頼性を高めるため，HA構成またはクラスタ構成を推奨しています。また，クラスタ構成では，HiRDBと通信サーバfor Billerの別のマシンでのセットアップを推奨しています。

このように，システム構成を決定する際に，考慮する点を次に示します。

HA構成にするか，クラスタ構成にするか

HiRDBを同一マシン上にセットアップするか，別のマシンにセットアップするか

システム構成の概要，および各構成で必要なソフトウェアについては，「2.3　システム構成の種類」，および「2.4　必要なソフトウェア」を参照してください。

なお，通信サーバでは，HA構成とクラスタ構成を併用できません。また，HA構成，およびクラスタ構成とも，HiRDBと通信サーバfor Billerを別のマシンにセットアップすると，DBバッチ処理機能を使用できません。この場合，DB Utility for Billerを導入すると，DBバッチ処理機能を使用できます。DB Utility for Billerについては，「付録D　DB Utility for Biller」を参照してください。

2.2　MPNとの接続形態

MPNと，通信サーバ，基幹システムなどの接続形態および接続順序を次に示します。

図2-1　MPNとの接続形態

注※

暗号化装置を付加したルーターでも代替できます。

基幹システムおよび通信サーバ間のネットワークプロトコルは収納機関で任意に決定できます。また，通信サーバ，MPN，およびMPNセンタ間のネットワークプロトコルはTCP/IPです。

暗号化装置，MPN間のデータは暗号化されます。

2.3　システム構成の種類

通信サーバfor Billerでは，HA構成，およびクラスタ構成で構築・運用ができます。ここでは，HA構成，およびクラスタ構成について説明します。

＜この節の構成＞

2.3.1　HA構成の形態

2.3.2　クラスタ構成の形態

2.3.1　HA構成の形態

通信サーバfor Billerを含むシステムのHA構成には，次の2種類があります。

通信サーバfor Biller単独でのHA構成

通信サーバBaseと通信サーバfor Biller双方でのHA構成

それぞれの構成で，通信サーバfor Biller，または通信サーバBaseに障害が発生したときの系切り替え処理の流れについて説明します。

なお，通信サーバBaseでの障害の発生を検知するためには，監視コマンドを作成する必要があります。通信サーバBaseに障害が発生すると，監視コマンドはその障害を検知して停止します。HAモニタは，監視コマンドの停止を検知して，系切り替えを行います。

＜この項の構成＞

(1)　通信サーバfor Biller単独でのHA構成

(2)　通信サーバBaseと通信サーバfor Biller双方でのHA構成

(1)　通信サーバfor Biller単独でのHA構成

通信サーバfor Billerのオンライン機能で障害が発生したときだけ切り替えを行う構成です。この構成には，障害が発生したときに通信サーバfor Billerだけを切り替える構成と，通信サーバBaseおよび通信サーバfor Billerを切り替える構成があります。

通信サーバfor Billerだけを切り替える構成
通信サーバfor Billerのオンライン機能で障害が発生したときに，通信サーバfor Billerだけを切り替える構成です。
この場合，障害発生時の系切り替え処理は，次のような流れとなります。

図2-2　系切り替え処理の流れ（通信サーバfor Biller単独でのHA構成で，通信サーバfor Billerだけを切り替える場合）

通信サーバBaseおよび通信サーバfor Billerを切り替える構成
通信サーバfor Billerのオンライン機能で障害が発生したときに，通信サーバBaseおよび通信サーバfor Billerを切り替える構成です。通信サーバBaseのファイル転送機能を常時使用する運用では，この構成を推奨します。なお，通信サーバBaseのファイル転送機能で障害が発生したときは，切り替えは行われません。
この場合，障害発生時の系切り替え処理は，次のような流れとなります。

図2-3　系切り替え処理の流れ（通信サーバfor Biller単独でのHA構成で，通信サーバBaseおよび通信サーバfor Billerを切り替える場合）

(2)　通信サーバBaseと通信サーバfor Biller双方でのHA構成

通信サーバBaseのファイル転送機能または通信サーバfor Billerのオンライン機能で障害が発生したときに切り替えを行う構成です。通信サーバBaseと通信サーバfor Billerを一つのグループとして定義し，リソースサーバを使った連動系切り替えを行います。通信サーバBaseのファイル転送機能で障害が発生したときにも切り替えを行う場合は，この構成にしてください。

この場合，障害発生時の系切り替え処理は，次のような流れとなります。

図2-4　系切り替え処理の流れ（通信サーバBaseと通信サーバfor Biller双方でのHA構成）

リソースサーバ，連動系切り替え，およびHAモニタの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

2.3.2　クラスタ構成の形態

クラスタ構成は，複数のマシンで一つのシステムとして運用できます。複数のマシンで電文を処理できるため，システム全体としての可用性が高められます。また，マシンに掛かる負荷を分散できます。クラスタ構成での通信形態を次に示します。

図2-5　クラスタ構成での通信形態

障害が発生したときは，それ以外のマシンで電文が処理されるため，システム全体としては，通常と変わらず運用できます。障害が発生した時の通信形態を次に示します。

図2-6　クラスタ構成で障害が発生したときの通信形態

クラスタ構成の場合の起動と停止については，「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

2.4　必要なソフトウェア

通信サーバfor Billerの前提OSおよび前提ソフトウェアについて説明します。

＜この節の構成＞

2.4.1　前提OS

2.4.2　前提ソフトウェア

2.4.3　ソフトウェア構成

2.4.1　前提OS

AIX 5Lの場合

AIX 5L Version 5.1，AIX 5L Version 5.2，またはAIX 5L Version 5.3

HP-UXの場合

HP-UX 11.0またはHP-UX 11i

2.4.2　前提ソフトウェア

HA構成の場合とクラスタ構成の場合の，前提ソフトウェアについて説明します。

＜この項の構成＞

(1)　HA構成の場合

(2)　クラスタ構成の場合

(1)　HA構成の場合

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合と，HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合で，前提ソフトウェアは異なります。

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合

HAモニタ

HiRDB High Availability，またはHiRDB Advanced High Availability

HiRDB/Single Server，またはHiRDB/Parallel Server

Hitachi Multi Payment Network communications server Base

TP1/Client/W

TP1/Extension 1

TP1/High Availability

TP1/Server Base

共通ソフトウェア

HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合

HiRDB側のマシン

HiRDB/Single Server，またはHiRDB/Parallel Server

Hitachi Multi Payment Network Database Utility for Biller

通信サーバfor Biller側のマシン

HAモニタ

HiRDB/Run Time

Hitachi Multi Payment Network communications server Base

TP1/Client/W

TP1/Extension 1

TP1/High Availability

TP1/Server Base

共通ソフトウェア

(2)　クラスタ構成の場合

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合と，HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合で，前提ソフトウェアは異なります。なお，クラスタ構成では，HiRDBと通信サーバfor Billerの別のマシンでのセットアップを推奨しています。

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合

HiRDB/Single Server，またはHiRDB/Parallel Server

Hitachi Multi Payment Network communications server Base

TP1/Client/W

TP1/Extension 1

TP1/Server Base

共通ソフトウェア

HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合

HiRDB側のマシン

HiRDB/Single Server，またはHiRDB/Parallel Server

Hitachi Multi Payment Network Database Utility for Biller

通信サーバfor Biller側のマシン

HiRDB/Run Time

Hitachi Multi Payment Network communications server Base

TP1/Client/W

TP1/Extension 1

TP1/Server Base

共通ソフトウェア

2.4.3　ソフトウェア構成

通信サーバfor Billerと前提ソフトウェアのソフトウェア構成について，HA構成の場合，およびクラスタ構成の場合で示します。

＜この項の構成＞

(1)　HA構成の場合

(2)　クラスタ構成の場合

(1)　HA構成の場合

HA構成の場合のソフトウェア構成を次に示します。

図2-7　HA構成のソフトウェア構成（HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合）

図2-8　HA構成のソフトウェア構成（HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合）

(2)　クラスタ構成の場合

クラスタ構成の場合のソフトウェア構成を次に示します。

図2-9　クラスタ構成のソフトウェア構成（HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合）

図2-10　クラスタ構成のソフトウェア構成（HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合）

2.5　システム構成例

通信サーバfor Billerのシステム構成例を示します。

＜この節の構成＞

2.5.1　HA構成の場合

2.5.2　クラスタ構成の場合

2.5.1　HA構成の場合

HA構成の場合のシステム構成例について説明します。通信サーバfor Billerでは，1：1系切り替え構成で，HAモニタの系切り替え機能を使用します。

＜この項の構成＞

(1)　HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき

(2)　HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき

(1)　HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき

HA構成の場合に，HiRDBと通信サーバfor Billerを同一マシン上にセットアップするときのシステム構成例を次に示します。HiRDBと通信サーバfor Billerを同一マシン上にセットアップすると，DBバッチ処理機能を使用できます。

図2-11　HA構成の場合のシステム構成例（HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき）

注※

暗号化装置を付加したルーター

(2)　HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき

HA構成の場合に，HiRDBと通信サーバfor Billerを別のマシンにセットアップするときのシステム構成例を次に示します。HiRDBと通信サーバfor Billerを別のマシンにセットアップすると，DBバッチ処理機能は使用できません。このようなときは，HiRDBのマシンにDB Utility for Billerを導入すると，導入したマシン上でDBバッチ処理機能を使用できるようになります。この構成例ではDB Utility for Billerを導入しています。DB Utility for Billerについては，「付録D　DB Utility for Biller」を参照してください。

図2-12　HA構成の場合のシステム構成例（HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき）

注※

暗号化装置を付加したルーター

2.5.2　クラスタ構成の場合

クラスタ構成の場合のシステム構成例を次に示します。

＜この項の構成＞

(1)　HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき

(2)　HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき

(1)　HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき

クラスタ構成の場合に，HiRDBと通信サーバfor Billerを同一マシン上にセットアップするときのシステム構成例を次に示します。HiRDBと通信サーバfor Billerを同一マシン上にセットアップすると，DBバッチ処理機能を使用できます。

図2-13　クラスタ構成の場合のシステム構成例（HiRDBと通信サーバfor Billerを同一マシン上にセットアップするとき）

注※

暗号化装置を付加したルーター

(2)　HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき

クラスタ構成の場合に，HiRDBと通信サーバfor Billerを別のマシンにセットアップするときのシステム構成例を次に示します。HiRDBと通信サーバfor Billerを別のマシンにセットアップすると，DBバッチ処理機能は使用できません。このようなときは，HiRDBのマシンにDB Utility for Billerを導入すると，導入したマシン上でDBバッチ処理機能を使用できるようになります。この構成例ではDB Utility for Billerを導入しています。DB Utility for Billerについては，「付録D　DB Utility for Biller」を参照してください。

図2-14　クラスタ構成の場合のシステム構成例（HiRDBと通信サーバfor Billerを別のマシンにセットアップするとき）

注※

暗号化装置を付加したルーター

3.　システム構築の流れと環境設定

この章では，通信サーバfor Billerのシステム構築の流れ，通信サーバ管理者の設定，および各ソフトウェアの環境設定について説明します。

＜この章の構成＞

3.1　システム構築の流れ

3.2　通信サーバ管理者の設定

3.3　前提ソフトウェアの環境設定

3.4　通信サーバfor Billerのインストールと環境設定

3.1　システム構築の流れ

通信サーバfor Billerは，次の流れで構築します。各手順については，図中に示した個所を参照してください。

システムの構成形態に関係なく，同じ流れで構築します。

図3-1　システム構築の流れ

システム構築の流れ

通信サーバ管理者の設定
通信サーバfor Billerのシステム構築をする前に，通信サーバ管理者を設定します。通信サーバ管理者に必要な権限については，「3.2　通信サーバ管理者の設定」を参照してください。

前提ソフトウェアの環境設定
通信サーバfor Billerをインストールする前に，前提となるソフトウェアのインストールおよび環境設定をします。前提となるソフトウェアには，OpenTP1，HiRDB，共通ソフトウェア，通信サーバBase，およびHAモニタ（HA構成の場合）があります。
インストールおよび環境設定の手順については，「3.3　前提ソフトウェアの環境設定」を参照してください。

通信サーバfor Billerのインストールと環境設定
通信サーバfor Billerのインストールおよび環境設定をします。
インストールおよび環境設定の手順については，「3.4　通信サーバfor Billerのインストールと環境設定」を参照してください。

トレースの設定
通信サーバシステム定義の設定のために，プロセス別トレースのトレースファイルサイズおよびトレースファイル数の見積もりをします。また，システム構築時にテストを実施するとき，またはトラブルシュート時に詳細な障害情報が必要になったときには，トレース出力レベルおよびしきい値の見直しが必要です。
設定手順については，「4.6　トレースの設定」を参照してください。

OpenTP1の定義
OpenTP1の定義をします。OpenTP1の定義は，通信サーバfor Billerが提供する業務系SPPについての定義です。システムの構成形態に関係なく必要です。
定義方法については，「4.2　OpenTP1の定義」を参照してください。

HiRDBの定義
HiRDBの定義をします。HiRDBの定義は，DBを使用するための定義です。システムの構成形態に関係なく必要です。
定義方法については，「4.3　HiRDBの定義」を参照してください。

通信サーバシステム定義
通信サーバシステム定義をします。通信サーバシステム定義は，通信サーバfor Billerの動作を制御するための定義です。システムの構成形態に関係なく必要です。
定義方法については，「4.4　通信サーバシステム定義」を参照してください。

HAモニタの定義
HAモニタの定義をします。HAモニタの定義は，HA環境を構築するための定義です。HA構成の場合だけに必要です。
定義方法については，「4.5　HAモニタの定義」を参照してください。

DBへのテーブルの作成
HiRDBに，情報を格納するためのテーブルを作成します。通信サーバfor Billerに一つだけ作成するテーブルと，通信サーバシステム定義に定義してある収納機関コードごとに作成するテーブルがあります。
作成するテーブルの種類，およびテーブルの作成手順については，「5　DBへのテーブルの作成」を参照してください。

ユーザーコールバックの作成
データ解析機能を使用する場合は，ユーザーコールバックを作成してください。データ解析機能を使用すると，OCR情報やバーコード情報などのユーザー独自のデータから，「お客様番号（納付番号）」，「確認番号」，「納付区分」や「地公体任意情報」などを取得できます。
ユーザーコールバックで取得する情報，およびユーザーコールバックの作成手順については，「6　ユーザーコールバックの作成」を参照してください。

3.2　通信サーバ管理者の設定

通信サーバfor Billerのシステムを構築する前に，通信サーバ管理者を設定します。通信サーバ管理者をOS（AIX 5L，またはHP-UX）に登録します。通信サーバ管理者には，次の環境変数を設定してください。

表3-1　通信サーバ管理者の環境に設定する環境変数

環境変数名
設定内容

HMPNDIR
通信サーバfor Billerのセットアップディレクトリを絶対パスで指定します。

DCDIR
OpenTP1セットアップディレクトリを絶対パスで指定します。

DCCONFPATH
OpenTP1の各定義ファイルが格納されているディレクトリを絶対パスで指定します。

DCHOST
クラスタ構成の場合に指定します。
クラスタ構成で使用しているTP1/Server Baseのホスト名，およびポート番号を指定します。

PATH
通信サーバfor Billerが提供するコマンドが動作するために必要なパスを指定します。
（OpenTP1セットアップディレクトリ）/bin:（HiRDBセットアップディレクトリ）/bin:（通信サーバfor Billerセットアップディレクトリ）/bin

LIBPATH（AIX 5Lの場合）
SHLIB_PATH（HP-UXの場合）
共用ライブラリのサーチパスを指定します。
/lib:/usr/lib:/opt/hitachi/common/lib:（OpenTP1セットアップディレクトリ）/lib:（HiRDBセットアップディレクトリ）/client/lib:（HiRDBセットアップディレクトリ）/lib:（通信サーバfor Billerセットアップディレクトリ）/usrlib:（通信サーバfor Billerセットアップディレクトリ）/lib

NLSPATH
メッセージカタログへのパスを指定します。
/usr/lib/nls/msg/%L/%N:/usr/lib/nls/%l/%t/%c/%N:（通信サーバfor Billerセットアップディレクトリ）/lib/msg/%L/%N

LANG
言語環境を指定します。

AIX 5Lの場合
CまたはJa_JP

HP-UXの場合
Cまたはja_JP.SJIS

PDDIR
HiRDBのセットアップディレクトリを絶対パスで指定します。DBバッチ処理のコマンドを実行する場合に必要です。

PDHOST
通信サーバfor Billerで使用するDBがHiRDBの場合に，HiRDBのホスト名を指定します。HiRDB/Single Serverの場合はHiRDB/Single Serverのあるホスト名を，HiRDB/Parallel Serverの場合はシステムマネジャのあるホスト名を指定します。また，通信サーバシステム定義の「BL_ENV」に指定した「PDHOST」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDNAMEPORT
HiRDBサーバのポート番号を指定します。通信サーバシステム定義の「BL_ENV」に指定した「PDNAMEPORT」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDUSER
HiRDBにアクセスするユーザー名，およびパスワードを指定します。指定するユーザー名は通信サーバ管理者にしてください。通信サーバシステム定義の「BL_ENV」に指定した「PDUSER」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDCONFPATH
HiRDBのシステム定義ファイルを格納するディレクトリを絶対パスで指定します。DBバッチ処理のコマンドを実行する場合に必要です。

環境変数の設定例を次に示します。

設定例の環境

OS：HP-UX

システム構成：HA構成

通信サーバfor Billerのセットアップ先：/home/HMPN

OpenTP1のセットアップ先：/home/OpenTP1

HiRDB/Single Serverのセットアップ先：/home/HiRDB

HiRDB/Single Serverのホスト名：host1

HiRDB/Single Serverのポート番号：20000

HiRDB/Single Serverにアクセスするユーザー名およびパスワード：'"mpnha"/"mpnha"'

設定例（shの場合）

HMPNDIR=/home/HMPN
export HMPNDIR

DCDIR=/home/OpenTP1
DCCONFPATH=${DCDIR}/conf
export DCDIR DCCONFPATH

PDDIR=/home/HiRDB
PDHOST=host1
PDNAMEPORT=20000
PDUSER='"mpnha"/"mpnha"'
PDCONFPATH=${PDDIR}/conf
export PDDIR PDHOST PDNAMEPORT PDUSER PDCONFPATH

PATH=${DCDIR}/bin:${PDDIR}/bin:${HMPNDIR}/bin:${PATH}
SHLIB_PATH=/lib:/usr/lib:/opt/hitachi/common/lib:${DCDIR}/lib:${PDDIR}/client/lib:${PDDIR}/lib:${HMPNDIR}/usrlib:${HMPNDIR}/lib:${SHLIB_PATH}
NLSPATH=/usr/lib/nls/msg/%L/%N:/usr/lib/nls/%l/%t/%c/%N:${HMPNDIR}/lib/msg/%L/%N:${NLSPATH}
LANG=ja_JP.SJIS
export PATH SHLIB_PATH NLSPATH LANG

3.3　前提ソフトウェアの環境設定

通信サーバfor Billerをインストールする前に，前提ソフトウェアのインストールおよび環境設定をしてください。なお，各ソフトウェアのインストールおよび環境設定の手順については，各ソフトウェアのマニュアルを参照してください。

前提ソフトウェアは，構成の種類によって異なります。各構成での前提ソフトウェアについては，「2.4.2　前提ソフトウェア」を参照してください。

OpenTP1
OpenTP1のインストールおよび環境設定をしてください。なお，通信サーバ管理者には，OpenTP1管理者の権限が必要です。

HiRDB
HiRDBのインストールおよび環境設定をしてください。HiRDBは通信サーバfor Billerと同一マシン上，または別のマシンにセットアップできます。ただし，HiRDBを通信サーバfor Billerと別のマシンにセットアップする場合，通信サーバfor BillerのDBバッチ処理機能は使用できません。
HiRDBをセットアップしたあと，次に示すHiRDBの権限を与えられたユーザーを作成してください。

権限 | 説明
CONNECT権限 | HiRDBに接続するために必要な権限
スキーマ定義権限 | スキーマを定義するために必要な権限
RDエリア権限 | RDエリアを使用するために必要な権限
アクセス権限 | SELECT権限 | 表の行データを検索するために必要な権限
INSERT権限 | 表の行データを追加するために必要な権限
DELETE権限 | 表の行データを削除するために必要な権限
UPDATE権限 | 表の行データを更新するために必要な権限

DBへのテーブルの作成は，ここで作成するユーザーが必ず行ってください。なお，このユーザーが通信サーバ管理者である必要はありません。

共通ソフトウェア
共通ソフトウェアのインストールおよび環境設定をしてください。なお，通信サーバ管理者には，共通ソフトウェアでの実行グループの制限があります。共通ソフトウェアの実行グループの制限に関する設定については，共通ソフトウェアの購入元に確認してください。

定義名の設定

共通ソフトウェアの環境設定ファイル（オンライン電文用）には，次の定義名を設定してください。

定義名 | 設定内容（指定値） | 編集可否
CenterState | 共通ソフトウェアのAPIでAPIを呼び出すときの引数を変化させる情報（N） | ×

（凡例）

×：必ず，設定内容欄の（）内の値を指定する

通信サーバ管理者の権限の設定

共通ソフトウェアの環境設定ファイル（オンライン電文用）の「LogFileName」に指定されているログファイルの出力先ディレクトリに，通信サーバ管理者が読み書きできる権限を設定します。共通ソフトウェアの環境設定完了後に権限を設定してください。

なお，権限を設定したあとに通信サーバ管理者を変更した場合は，ログファイルの出力先ディレクトリとそこに格納されているログファイルの権限を設定し直してください。

通信サーバBase
通信サーバBaseのインストールをしてください。通信サーバBaseは，通信サーバfor Billerのセットアップ時に，一緒にセットアップされます。セットアップ以外の環境設定については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

HAモニタ
HAモニタのインストールおよび環境設定をしてください。HAモニタはHA構成の場合に必要です。通信サーバfor Billerを設定したあとに実施することをお勧めします。また，HAモニタを使用するためには，現用系および予備系の/etc/hostsファイルおよび/etc/servicesファイルの設定が必要です。/etc/hostsファイルおよび/etc/servicesファイルの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。
また，/etc/hostsファイルおよび/etc/servicesファイルの記述例については，「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」または「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」を参照してください。

3.4　通信サーバfor Billerのインストールと環境設定

通信サーバfor Billerのインストール，統合トレースの設定，および環境設定の方法について説明します。

＜この節の構成＞

3.4.1　インストール/環境設定する前に

3.4.2　通信サーバfor Billerのインストール

3.4.3　統合トレースの設定

3.4.4　通信サーバfor Billerの環境設定

3.4.5　ロウ論理ボリュームの作成

3.4.6　業務系SPPの格納

3.4.1　インストール/環境設定する前に

通信サーバfor Billerのインストールおよび環境設定をする前に注意する点を次に示します。

セットアップディレクトリについて

セットアップ処理では，セットアップディレクトリに設定されているオーナー名およびグループ名が，通信サーバ管理者として適用されます。このため，インストールディレクトリにセットアップする場合は，インストールディレクトリのルートディレクトリのオーナー名およびグループ名を，通信サーバ管理者に設定してください。

インストールディレクトリをセットアップディレクトリとして使用する場合以外は，インストールディレクトリ下のディレクトリおよびファイルの属性を変更しないでください。

セットアップディレクトリには，/usr，/usr/binなどのOSが使用するディレクトリを指定しないでください。OSが動作しなくなるおそれがあります。

セットアップコマンドについて

セットアップコマンド（hmpnsetup）の実行中は，/etc/inittabを編集しないでください。OSが正常に動作しなくなるおそれがあります。

一つのマシンに複数の共通ソフトウェアを構築することはできません。そのため，一つのマシンに複数の通信サーバfor Billerを構築することもできません。

セットアップコマンドの実行に失敗した場合は，一度アンセットアップしてから再度セットアップコマンドを実行してください。

任意で作成したファイルは，アンセットアップ後も残ります。不要なファイルは，移動または削除してください。

上書きセットアップについて

セットアップされているソフトウェアと上書きセットアップするソフトウェアの組み合わせによって，上書きセットアップできる場合と，できない場合があります。上書きセットアップの実行可否を次に示します。

表3-2　上書きセットアップの実行可否

セットアップされているソフトウェア | 上書きセットアップするソフトウェア
通信サーバBase | 通信サーバfor Biller
通信サーバBase | ○ | ○
通信サーバfor Biller | × | ○

（凡例）

○：上書きセットアップできますが，アンセットアップしてからセットアップすることを推奨します。

×：上書きセットアップできません。必ずアンセットアップしてから，セットアップしてください。

3.4.2　通信サーバfor Billerのインストール

通信サーバfor Billerをインストールするには，日立PPインストーラを実行してください。アンインストールする場合も同様です。

3.4.3　統合トレースの設定

通信サーバfor Billerでは，統合トレース情報ファイルに，必要なトレース情報を出力します。統合トレースの設定を変更する方法については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

なお，デフォルトの設定のままで通信サーバfor Billerを運用する場合には，変更は必要ありません。必要に応じて変更してください。

3.4.4　通信サーバfor Billerの環境設定

通信サーバfor Billerの環境設定は，次の手順で行ってください。

この手順では，通信サーバfor Billerだけでなく，通信サーバBaseの環境設定も行います。通信サーバBaseだけの環境設定を行う場合は，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

セットアップディレクトリを作成する
次の形式で，通信サーバfor Billerのセットアップディレクトリを作成してください。この操作は通信サーバ管理者で行ってください。

$ mkdir セットアップディレクトリ

セットアップコマンド（hmpnsetup）を実行する※
次の形式で，セットアップコマンドを実行してください。この操作はスーパーユーザーで行ってください。

# /opt/hitachi/HMPN/bin/hmpnsetup -s （通信サーバfor Billerセットアップディレクトリ） -T （OpenTP1セットアップディレクトリ）

なお，通信サーバfor Billerをアンセットアップする場合は，セットアップコマンドに「-d」オプションを付けて実行してください。
セットアップコマンドの詳細については，「10.3　コマンドの詳細　hmpnsetup（セットアップ）」を参照してください。

注※

環境変数LANG，およびTZを必ず設定した環境で，セットアップコマンドを実行してください。

3.4.5　ロウ論理ボリュームの作成

通信サーバfor Billerでは，状態を保持するために，状態管理ファイル用ロウ論理ボリュームおよび業務系SPP状態ファイル用ロウ論理ボリュームの二つが必要です。この二つのロウ論理ボリューム名は，それぞれ異なる名称で作成してください。

HA構成の場合は，これらのロウ論理ボリュームを共有ディスク上に作成してください。これによって，ほかの通信サーバfor Billerで障害が発生した場合でも予備系に状態を引き継ぎ，運用を継続できます。

ここでは，通信サーバfor Billerに必要なロウ論理ボリュームの作成方法について説明します。

＜この項の構成＞

(1)　作成手順

(2)　ロウ論理ボリューム名の設定

(1)　作成手順

次の手順に従って，状態管理ファイル用ロウ論理ボリューム，および業務系SPP状態ファイル用ロウ論理ボリュームを作成してください。

ロウ論理ボリュームを作成する
ロウ論理ボリュームを作成するには，次のコマンドを実行してください。この操作はスーパーユーザーで実行してください。ロウ論理ボリュームを作成するコマンドはOSが提供するコマンドなので，各OSの仕様に従って指定してください。なお，コマンドを実行すると，二つのロウ論理ボリュームが作成されますが，通信サーバfor Billerでは，先頭に「r」が付加されたロウ論理ボリュームを使用します。

AIX 5Lの場合

# mklv -y ロウ論理ボリューム名 ボリュームグループ名 物理区画数

ロウ論理ボリューム名およびボリュームグループ名
ロウ論理ボリューム名およびボリュームグループ名は，ユーザー任意で作成できます。ただし，HA構成の場合は，OpenTP1が使用するボリュームグループと同じものを指定してください。

物理区画数
1を指定してください。

HP-UXの場合

# lvcreate -L ロウ論理ボリュームサイズ -n ロウ論理ボリューム名 ボリュームグループ名

ロウ論理ボリュームサイズ
4を指定してください。

ロウ論理ボリューム名およびボリュームグループ名
ロウ論理ボリューム名およびボリュームグループ名は，ユーザー任意で作成できます。ただし，HA構成の場合は，OpenTP1が使用するボリュームグループと同じものを指定してください。

ロウ論理ボリュームの所有者および属性を変更する
ロウ論理ボリューム名の先頭に「r」が付加されたロウ論理ボリュームの所有者とグループを，通信サーバ管理者と合わせてください。また，ロウ論理ボリュームの所有者とグループの権限を，読み取りおよび書き込みできるように設定してください。

(2)　ロウ論理ボリューム名の設定

作成した二つのロウ論理ボリュームを使用するには，通信サーバシステム定義に指定する必要があります。ロウ論理ボリュームを変更した場合は，通信サーバシステム定義の「RAW_BL_STAT」および「RAW_WORKPRC_STAT」の定義値を変更し，ファイル初期化コマンドを実行する必要があります。

通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

ファイル初期化コマンドについては，「10.3　コマンドの詳細　hmpnblinit（ファイル初期化）」を参照してください。

注意

ロウ論理ボリュームは「/dev」の下に作成されます。mvコマンド，rmコマンドなどで直接操作しないでください。

3.4.6　業務系SPPの格納

（通信サーバfor Billerセットアップディレクトリ）/aplib/の業務系SPPをすべて，通信サーバfor Billerが動作するOpenTP1の（OpenTP1のセットアップディレクトリ）/aplib/に格納してください。

4.　システム定義

この章では，システム定義の概要，OpenTP1の定義，HiRDBの定義，通信サーバシステム定義，HAモニタの定義，および通信サーバシステム定義に必要なトレースの設定について説明します。

＜この章の構成＞

4.1　システム定義の概要

4.2　OpenTP1の定義

4.3　HiRDBの定義

4.4　通信サーバシステム定義

4.5　HAモニタの定義

4.6　トレースの設定

4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）

4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

4.9　定義ファイルの記述例（クラスタ構成の場合）

4.1　システム定義の概要

通信サーバfor Billerでは，システム構築の際，次に示すシステム定義ファイルを作成する必要があります。

OpenTP1の定義

HiRDBの定義

通信サーバシステム定義

HAモニタの定義

ここでは，各定義の構成と特長，システム構成の定義の特長，および環境変数の定義の優先順位について説明します。

＜この節の構成＞

4.1.1　定義の構成と特長

4.1.2　システム構成の定義の特長

4.1.1　定義の構成と特長

通信サーバfor Billerは，通信サーバfor Billerの業務系SPPと，収納業務プログラムのユーザー作成UAPとの間で電文を送受信します。

そのため，OpenTP1でのSPPの定義内容，および収納業務プログラムでのユーザー作成UAPの定義内容を通信サーバシステム定義に合わせて定義する必要があります。これらの定義の関連を次に示します。

図4-1　OpenTP1の定義・通信サーバシステム定義・収納業務プログラムの関連

OpenTP1の定義，通信サーバシステム定義，および収納業務プログラムのユーザー作成UAP用定義で関連がある定義には，次の種類があります。

通信サーバ単位で使用するSPP用定義

収納機関単位で使用するSPP用定義

それぞれについて，定義の特長を説明します。

＜この項の構成＞

(1)　通信サーバ単位で使用するSPP用定義

(2)　収納機関単位で使用するSPP用定義

(1)　通信サーバ単位で使用するSPP用定義

通信サーバ単位で使用するSPP用定義は，通信サーバfor Billerに必要な収納カウンタ情報取得SPP，および収納業務受付SPPの定義です。これらのSPPは，収納機関に依存しません。

通信サーバ単位で使用するSPP用定義について，OpenTP1の定義と通信サーバシステム定義で対応している定義ファイル，および定義名を次に示します。

図4-2　通信サーバ単位で使用するSPP用定義

表4-1　通信サーバ単位で使用するSPP用定義

OpenTP1の定義
通信サーバシステム定義

通信サーバfor Biller共通定義
[HMPN/BL]

定義名
ファイル名
定義名
定義内容

収納カウンタ情報取得SPP用ユーザサービス定義
HMpnCnt※
COUNT_USERSV
収納カウンタ情報取得SPPのユーザサーバ名

COUNT_SERVICEGRP
収納カウンタ情報取得SPPのサービスグループ名

COUNT_SERVICE
収納カウンタ情報取得SPPのサービス名

収納業務受付SPP用ユーザサービス定義
HMpnRdb※
RDB_USERSV
収納業務受付SPPのユーザサーバ名

注※

サンプルファイルのファイル名を使用しています。環境に合わせて変更できます。

(2)　収納機関単位で使用するSPP用定義

収納機関単位で使用するSPP用定義は，各収納機関で使用する業務系SPP，および各収納業務プログラムのユーザー作成UAPについて定義しています。収納機関単位で定義することで，各収納機関で異なるサービスを実現できます。

収納機関単位で使用するSPP用定義のうち，通信サーバの業務系SPPを定義するOpenTP1の定義と通信サーバシステム定義で対応している定義ファイル，および定義名を次に示します。

図4-3　収納機関単位で使用するSPP用定義（通信サーバの業務系SPP）

表4-2　収納機関単位で使用するSPP用定義（通信サーバの業務系SPP）

OpenTP1の定義
通信サーバシステム定義

通信サーバfor Biller業務系SPP定義
[HMPN/BL/（収納機関コード）]

定義名
ファイル名
定義名
定義内容

－
－
PAY_TYPE
納付金区分

照会SPP用ユーザサービス定義
HMpnRefA※
REF_USERSV
照会SPPのユーザサーバ名

REF_SERVICEGRP
照会SPPのサービスグループ名

REF_SERVICE
照会SPPのサービス名

消込SPP用ユーザサービス定義
HMpnPayA※
PAY_USERSV
消込SPPのユーザサーバ名

PAY_SERVICEGRP
消込SPPのサービスグループ名

PAY_SERVICE
消込SPPのサービス名

取消SPP用ユーザサービス定義
HMpnCanA※
CAN_USERSV
取消SPPのユーザサーバ名

CAN_SERVICEGRP
取消SPPのサービスグループ名

CAN_SERVICE
取消SPPのサービス名

再送確認SPP用ユーザサービス定義
HMpnResA※
RESEND_USERSV
再送確認SPPのユーザサーバ名

RESEND_SERVICEGRP
再送確認SPPのサービスグループ名

RESEND_SERVICE
再送確認SPPのサービス名

（凡例）

－：該当なし

注※

定義ファイル名は，各収納機関でユニークに設定してください。

次に，収納機関単位で使用するSPP用定義のうち，収納業務プログラムのユーザー作成UAPを定義する通信サーバシステム定義で対応している定義名を示します。

図4-4　収納機関単位で使用するSPP用定義（収納業務プログラム）

表4-3　収納機関単位で使用するSPP用定義（収納業務プログラム）

通信サーバシステム定義
収納業務プログラム

定義の種類
定義名
定義内容

収納業務プログラム共通定義
[HMPN/BL/SRV/（収納機関コード）/COM]
RPC_KIND
特定の収納業務プログラムの呼び出し
－

HOST_NAME
収納業務プログラムのホスト名
－

NAME_PORT
収納業務プログラムのポート番号
－

照会収納業務プログラムデフォルト定義
[HMPN/BL/SRV/（収納機関コード）/REF]
SERVICEGRP
収納業務プログラムの照会SPPのデフォルトのサービスグループ名
ユーザー作成UAP用定義

SERVICE
収納業務プログラムの照会SPPのデフォルトのサービス名

消込収納業務プログラムデフォルト定義
[HMPN/BL/SRV/（収納機関コード）/PAY]
SERVICEGRP
収納業務プログラムの消込SPPのデフォルトのサービスグループ名
ユーザー作成UAP用定義

SERVICE
収納業務プログラムの消込SPPのデフォルトのサービス名

取消収納業務プログラムデフォルト定義
[HMPN/BL/SRV/（収納機関コード）/CAN]
SERVICEGRP
収納業務プログラムの取消SPPのデフォルトのサービスグループ名
ユーザー作成UAP用定義

SERVICE
収納業務プログラムの取消SPPのデフォルトのサービス名

再送確認収納業務プログラムデフォルト定義
[HMPN/BL/SRV/（収納機関コード）/RESEND]
SERVICEGRP
収納業務プログラムの再送確認SPPのデフォルトのサービスグループ名
ユーザー作成UAP用定義

SERVICE
収納業務プログラムの再送確認SPPのデフォルトのサービス名

（凡例）

－：該当なし

4.1.2　システム構成の定義の特長

HA構成に必要な定義，およびクラスタ構成の定義の特長について説明します。

＜この項の構成＞

(1)　HA構成に必要な定義

(2)　クラスタ構成の定義の特長

(1)　HA構成に必要な定義

HA構成の場合，系切り替えをするため，現用系，および予備系のシステムで同じ定義内容にする必要があります。また，HAモニタの定義のほかに，OpenTP1，HiRDB，および通信サーバシステム定義でも，HA構成用の定義項目があります。

(2)　クラスタ構成の定義の特長

クラスタ構成の場合，各通信サーバのシステム定義で，クラスタ構成用の定義項目があります。各通信サーバで異なる値を定義する項目，および負荷の状況に合わせた電文の振り分けを実現する定義項目について説明します。

各通信サーバで異なる値を定義する項目

通信サーバシステム定義の次の定義項目については，クラスタ構成の各通信サーバで異なる値を定義する必要があります。

共通定義の「CENTER_CODE」

通信サーバfor Biller共通定義の「TARGET_HOST」，および「CHANNEL_NAME」

負荷の状況に合わせた電文の振り分けを実現する定義項目

クラスタ構成で必ず定義する項目のうち，通信サーバシステム定義の次に示す定義項目で，負荷の状況に合わせた電文の振り分けが実現できます。

通信サーバfor Biller共通定義の「CLUSTER_MODE=Y」

収納業務プログラム共通定義の「RPC_KIND=CALL」

負荷の状況に合わせた電文の振り分けについて，クラスタ構成ではない場合と比較して次に示します。

図4-5　負荷の状況に合わせた電文の振り分け（クラスタ構成）

CLUSTER_MODE=Yで，業務電文受信CUP，および業務系SPP間，RPC_KIND=CALLで，業務系SPP，および収納業務プログラム間の電文の振り分けを実現しています。負荷の状況に合わせて電文を振り分けることで，システムの可用性を高められます。

そのため，クラスタ構成の場合，RPC_KIND=CALLを推奨します。ただし，環境に合わせてRPC_KIND=CALLTOにしたり，また，クラスタ構成ではない場合も，収納業務プログラムを複数作成することで，RPC_KIND=CALLにしたりすることができます。

4.2　OpenTP1の定義

OpenTP1の定義の概要，定義の手順，通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連，およびOpenTP1の定義項目について説明します。

＜この節の構成＞

4.2.1　OpenTP1の定義の概要

4.2.2　OpenTP1の定義の手順

4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連

4.2.4　OpenTP1の定義項目

4.2.1　OpenTP1の定義の概要

OpenTP1の定義は，通信サーバfor Billerが提供する収納サービスについての定義です。OpenTP1の定義は，テキスト形式の定義ファイルに記述します。

OpenTP1の定義ファイルの一覧を次に示します。

表4-4　OpenTP1の定義ファイルの一覧

定義の種類 | 定義ファイル名 | 収納サービスの種類 | 説明 | サンプルファイルの有無
システム環境定義 | env | 地方税・地公体料金，一般料金，国庫金 | 通信サーバfor Billerのシステムの実行環境を定義します。 | ×
システムサービス構成定義 | sysconf | 通信サーバfor Billerの各SPPの構成，およびHA構成の系切り替えなどを定義します。 | ×
システム共通定義 | betranrc | 通信サーバfor Billerのシステムの実行環境を定義します。クラスタ構成の場合，または同一ホスト上の，通信サーバとは別のTP1/Server Baseで収納業務プログラムを稼働させる場合に定義します。 | ×
プロセスサービス定義 | prc | 通信サーバfor Billerの各SPPを管理するための実行環境を定義します。 | ×
ログサービス定義 | log | 通信サーバfor Billerのログの出力環境を定義します。 | ×
ユーザサービスデフォルト定義 | usrrc | 通信サーバfor Billerの各SPP用ユーザサービス定義を省略したときの値を定義します。 | ×
照会SPP用ユーザサービス定義 | HMpnRef※ | 地方税・地公体料金，一般料金 | 照会SPPの実行環境を定義します。 | ○
HMpnTRef※ | 国庫金
消込SPP用ユーザサービス定義 | HMpnPay※ | 地方税・地公体料金，一般料金 | 消込SPPの実行環境を定義します。 | ○
HMpnTPay※ | 国庫金
取消SPP用ユーザサービス定義 | HMpnCan※ | 地方税・地公体料金，一般料金 | 取消SPPの実行環境を定義します。 | ○
HMpnTCan※ | 国庫金
再送確認SPP用ユーザサービス定義 | HMpnRes※ | 地方税・地公体料金，一般料金 | 再送確認SPPの実行環境を定義します。 | ○
HMpnTRes※ | 国庫金
収納カウンタ情報取得SPP用ユーザサービス定義 | HMpnCnt※ | 地方税・地公体料金，一般料金，国庫金 | 収納カウンタ情報取得SPPの実行環境を定義します。 | ○
収納業務受付SPP用ユーザサービス定義 | HMpnRdb※ | 収納業務受付SPPの実行環境を定義します。 | ○

（凡例）

○：サンプルファイルがある

×：サンプルファイルがない

注

通信サーバfor Billerのシステム構築で，usrconf（ユーザサービス構成定義）の定義は不要です。通信サーバシステム定義で指定したユーザサーバをusrconf（ユーザサービス構成定義）に指定しないでください。usrconf（ユーザサービス構成定義）については，マニュアル「分散トランザクション処理機能 OpenTP1 システム定義」を参照してください。

注※

サンプルファイルを使用して，通信サーバシステム定義で収納機関ごとに設定した各SPPのユーザサーバ名のファイルを作成します。通信サーバシステム定義とOpenTP1の定義ファイルの関連については，「4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連」を参照してください。

なお，ここで説明する定義項目以外の定義項目については，マニュアル「分散トランザクション処理機能 OpenTP1 システム定義」を参照してください。

4.2.2　OpenTP1の定義の手順

OpenTP1の定義は，次の手順で行ってください。

定義ファイルを作成する
OpenTP1の定義には，サンプルファイルがある定義と，サンプルファイルがない定義があります。なお，サンプルファイルのファイル名は，定義ファイル名と同じです。定義ファイル名，およびサンプルファイルの有無については，「4.2.1　OpenTP1の定義の概要」を参照してください。定義ファイルについては，「4.2.4　OpenTP1の定義項目」を参照してください。

サンプルファイルがある定義の場合
サンプルファイルをコピーして，定義ファイルとして使用してください。サンプルファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/tp1

サンプルファイルがない定義の場合
ファイルを新規に作成してください。ファイル名については，「4.2.1　OpenTP1の定義の概要」を参照してください。

定義ファイルを編集する
必要に応じて，定義ファイルを編集してください。定義ファイルの編集方法については，マニュアル「分散トランザクション処理機能 OpenTP1 システム定義」を参照してください。

定義ファイルを所定のディレクトリに格納する
編集していないファイルも含めて，すべての定義ファイルを環境変数「DCCONFPATH」に指定したディレクトリに格納してください。

4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連

OpenTP1の定義ファイルは，通信サーバシステム定義ファイルと関連づけられています。定義ファイルの関連については，「4.1.1　定義の構成と特長」を参照してください。

OpenTP1の定義ファイルを作成する場合，ユーザサービス定義は，サンプルファイルを任意のディレクトリにコピーします。コピーで作成するファイルは，通信サーバシステム定義で収納機関コードごとに指定した各SPPのユーザサーバ名と同じです。この関連について，照会SPPの場合を次に示します。

通信サーバシステム定義ファイル

[COMMON]
：
：
[HMPN/BL/SRV/99999000]
AUTO_START             = "AUTO"
REF_USERSV             = "HMpnRef"※1
REF_SERVICEGRP         = "hmpn_ref_srvgrp"※2，※3
REF_SERVICE            = "hmpn_ref_srv"※2，※3

[HMPN/BL/SRV/99999000/COM]
：

OpenTP1ユーザサービス定義ファイル

set module                  = "HMpnRef"
set service_group           = "hmpn_ref_srvgrp"※3
set service                 = "hmpn_ref_srv=hmpn_ref_srv"※3
set parallel_count          = 1
set type                    = other
：
：

注※1

通信サーバシステム定義の「REF_USERSV」には，照会SPP用ユーザサービス定義のファイル名を指定します。収納機関単位のTP1/Server Baseで名称が重複してはいけません。

注※2

サービスグループ名およびサービス名の組み合わせは，各TP1/Server Baseで重複しないように，指定してください。

注※3

通信サーバシステム定義の「REF_SERVICEGRP」および「REF_SERVICE」には，照会SPP用ユーザサービス定義で指定したサービスグループ名，およびサービス名を指定します。

ユーザサービス定義ファイルは，この関連に注意して作成する必要があります。消込SPP，取消SPPなどの場合も同様に指定してください。

通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

4.2.4　OpenTP1の定義項目

OpenTP1の定義をファイルごとに説明します。なお，各項目の詳細については，マニュアル「分散トランザクション処理機能 OpenTP1 システム定義」を参照してください。

また，各定義ファイルの記述例については「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」，「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」または「4.9　定義ファイルの記述例（クラスタ構成の場合）」を参照してください。

＜この項の構成＞

(1)　システム環境定義（env）

(2)　システムサービス構成定義（sysconf）

(3)　システム共通定義（betranrc）

(4)　プロセスサービス定義（prc）

(5)　ログサービス定義（log）

(6)　ユーザサービスデフォルト定義（usrrc）

(7)　照会SPP用ユーザサービス定義（HMpnRef）

(8)　照会SPP用ユーザサービス定義（HMpnTRef）

(9)　消込SPP用ユーザサービス定義（HMpnPay）

(10)　消込SPP用ユーザサービス定義（HMpnTPay）

(11)　取消SPP用ユーザサービス定義（HMpnCan）

(12)　取消SPP用ユーザサービス定義（HMpnTCan）

(13)　再送確認SPP用ユーザサービス定義（HMpnRes）

(14)　再送確認SPP用ユーザサービス定義（HMpnTRes）

(15)　収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

(16)　収納業務受付SPP用ユーザサービス定義（HMpnRdb）

(1)　システム環境定義（env）

システム環境定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-5　システム環境定義

項目名
説明
定義値
定義値の変更
定義が必要な構成の種類

mode_conf
OpenTP1システムの開始方法を指定します。
MANUAL1
×
共通

user_command_online
システム開始/完了コマンドを次の形式で指定します。
（通信サーバfor Billerのセットアップディレクトリ）/bin/hmpnblstart※1
任意※2
×
共通

start_scheduling_timing
システム開始時のRPC受け付けの開始時期を指定します。
AFTER
×
共通

system_init_watch_time
システム初期化処理の待ち時間の最大値（単位：秒）を指定します。
600
○
共通

HMPNDIR
通信サーバfor Billerのセットアップディレクトリを絶対パスで指定します。
任意
○
共通

LIBPATH（AIX 5Lの場合）
SHLIB_PATH（HP-UXの場合）
共用ライブラリのサーチパスを次の形式で指定します。
/usr/lib:/opt/hitachi/common/lib: （OpenTP1セットアップディレクトリ）/lib:（HiRDBセットアップディレクトリ）/client/lib:（HiRDBセットアップディレクトリ）/lib:（通信サーバfor Billerセットアップディレクトリ）/usrlib:（通信サーバfor Billerセットアップディレクトリ）/lib
任意
○
共通

NLSPATH
メッセージカタログへのパスを次の形式で指定します。
/usr/lib/nls/msg/%L/%N:/usr/lib/nls/%l/%t/%c/%N:（通信サーバfor Billerセットアップディレクトリ）/lib/msg/%L/%N
任意
○
共通

PATH
コマンドが動作するために必要なパスを次の形式で指定します。
/usr/bin:/usr/mqm/bin:（OpenTP1セットアップディレクトリ）/bin:（通信サーバfor Billerセットアップディレクトリ）/bin
任意
○
共通

LANG※3
言語環境を指定します。

AIX 5Lの場合
CまたはJa_JP

HP-UXの場合
Cまたはja_JP.SJIS

△
共通

DCHOST
クラスタ構成の場合，TP1/Client/Wの環境変数「DCHOST」に指定した値を指定します。
任意
○
CL

（凡例）

○：「説明」欄の条件で，任意の値を指定する

△：「定義値」欄の値の中から指定する

×：必ず「定義値」欄の値を指定する

CL：クラスタ構成の場合，指定する項目

共通：どの構成でも指定する項目

注※1

システム開始/完了コマンドに指定する「hmpnblstart」は，手動で実行しないでください。

注※2

必ず「説明」欄の形式で指定してください。

注※3

通信サーバ管理者の使用言語環境と同じ言語環境を指定してください。

(2)　システムサービス構成定義（sysconf）

システムサービス構成定義には，サンプルファイルがありません。HA構成の場合，ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-6　システムサービス構成定義

項目名 | 説明 | 定義値 | 定義値の変更 | 定義が必要な構成の種類
uap_conf | ユーザサーバを実行するかどうかを指定します。 | Y | × | 共通
ha_conf | 系切り替えを使用するかどうかを指定します。 | Y | × | HA

（凡例）

×：必ず「定義値」欄の値を指定する

HA：HA構成の場合，指定する項目

共通：どの構成でも指定する項目

(3)　システム共通定義（betranrc）

システム共通定義には，サンプルファイルがありません。クラスタ構成の場合，または同一ホスト上の，通信サーバとは別のTP1/Server Baseで収納業務プログラムを稼働させる場合，ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-7　システム共通定義（OpenTP1の定義）

項目名
説明
定義値
定義値の変更
定義が必要な構成の種類

all_node
収納業務プログラムが稼働するすべてのTP1/Server Baseのノード名，およびポート番号を指定します。自ホストを示すホスト名，またはIPアドレスは指定できません。
「ノード名[:ポート番号]」の形式で指定してください。複数指定し，文字列を区切る場合は，「,」を使用してください。
任意
○
共通

（凡例）

○：「説明」欄の条件で，任意の値を指定する

共通：どの構成でも指定する項目

(4)　プロセスサービス定義（prc）

プロセスサービス定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-8　プロセスサービス定義

項目名
説明
定義値
定義値の変更
定義が必要な構成の種類

prcsvpath
ユーザサーバのパス名を次の形式で指定します。
（OpenTP1セットアップディレクトリ）/aplib
任意
○
共通

（凡例）

○：「説明」欄の条件で，任意の値を指定する

共通：どの構成でも指定する項目

(5)　ログサービス定義（log）

ログサービス定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。また，必ず定義値に記載している値を定義してください。表中にない項目については，環境に合わせて定義できます。

表4-9　ログサービス定義

項目名 | 説明 | 定義値 | 定義値の変更 | 定義が必要な構成の種類
log_notify_out | メッセージログ通知機能を使用するかどうかを指定します。 | Y | × | 共通
log_notify_allno | メッセージログのシステム内の通番を付けるかどうかを指定します。 | N | × | 共通
log_notify_prcid | 要求元のプロセスのプロセスIDを付けるかどうかを指定します。 | N | × | 共通
log_notify_prcno | メッセージログのプロセス内の通番を付けるかどうかを指定します。 | N | × | 共通
log_notify_sysid | OpenTP1識別子を付けるかどうかを指定します。 | N | × | 共通
log_notify_date | メッセージログの出力要求時の日付を付けるかどうかを指定します。 | N | × | 共通
log_notify_time | メッセージログの出力要求時の時刻を付けるかどうかを指定します。 | N | × | 共通
log_notify_hostname | メッセージログの出力要求元のホスト名を付けるかどうかを指定します。 | N | × | 共通
log_notify_pgmid | メッセージログの出力要求元のプログラムIDを付けるかどうかを指定します。 | N | × | 共通

（凡例）

×：必ず「定義値」欄の値を指定する

共通：どの構成でも指定する項目

(6)　ユーザサービスデフォルト定義（usrrc）

ユーザサービスデフォルト定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-10　ユーザサービスデフォルト定義

項目名
説明
定義値
定義値の変更
定義が必要な構成の種類

HMPNDIR
通信サーバfor Billerのセットアップディレクトリを絶対パスで指定します。
任意
○
共通

PATH
コマンドが動作するために必要なパスを次の形式で指定します。
/usr/bin:/usr/mqm/bin:（OpenTP1セットアップディレクトリ）/bin:（通信サーバfor Billerセットアップディレクトリ）/bin
任意
○
共通

LIBPATH（AIX 5Lの場合）
SHLIB_PATH（HP-UXの場合）
共用ライブラリパスのサーチパスを次の形式で指定します。
/usr/lib:/opt/hitachi/common/lib: （OpenTP1セットアップディレクトリ）/lib:（HiRDBセットアップディレクトリ）/client/lib:（HiRDBセットアップディレクトリ）/lib:（通信サーバfor Billerセットアップディレクトリ）/usrlib:（通信サーバfor Billerセットアップディレクトリ）/lib
任意
○
共通

NLSPATH
メッセージカタログへのパスを次の形式で指定します。
/usr/lib/nls/msg/%L/%N:/usr/lib/nls/%l/%t/%c/%N:（通信サーバfor Billerセットアップディレクトリ）/lib/msg/%L/%N
任意
○
共通

（凡例）

○：「説明」欄の条件で，任意の値を指定する

共通：どの構成でも指定する項目

(7)　照会SPP用ユーザサービス定義（HMpnRef）

照会SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-11　照会SPP用ユーザサービス定義（HMpnRef）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnRef | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_ref_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_ref_srv=hmpn_ref_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 4 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(8)　照会SPP用ユーザサービス定義（HMpnTRef）

照会SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-12　照会SPP用ユーザサービス定義（HMpnTRef）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnRef | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_ref_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_ref_srv=hmpn_trsref_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 4 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(9)　消込SPP用ユーザサービス定義（HMpnPay）

消込SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-13　消込SPP用ユーザサービス定義（HMpnPay）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnPay | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_pay_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_pay_srv=hmpn_pay_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 4 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(10)　消込SPP用ユーザサービス定義（HMpnTPay）

消込SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-14　消込SPP用ユーザサービス定義（HMpnTPay）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnPay | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_pay_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_pay_srv=hmpn_trspay_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 4 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(11)　取消SPP用ユーザサービス定義（HMpnCan）

取消SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-15　取消SPP用ユーザサービス定義（HMpnCan）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnCan | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_can_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_can_srv=hmpn_can_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 2 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(12)　取消SPP用ユーザサービス定義（HMpnTCan）

取消SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-16　取消SPP用ユーザサービス定義（HMpnTCan）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnCan | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_can_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_can_srv=hmpn_trscan_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 2 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(13)　再送確認SPP用ユーザサービス定義（HMpnRes）

再送確認SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-17　再送確認SPP用ユーザサービス定義（HMpnRes）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnRes | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_res_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_res_srv=hmpn_res_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 2 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(14)　再送確認SPP用ユーザサービス定義（HMpnTRes）

再送確認SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-18　再送確認SPP用ユーザサービス定義（HMpnTRes）

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnRes | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_res_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_res_srv=hmpn_trsres_srv | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 2 | ○ | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

(15)　収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

収納カウンタ情報取得SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-19　収納カウンタ情報取得SPP用ユーザサービス定義

項目名 | 説明 | サンプルファイルの値 | 変更 | 定義が必要な構成の種類
module | 実行形式プログラム名を指定します。 | HMpnCnt | × | 共通
service_group | サービスグループ名を指定します。 | hmpn_cnt_srvgrp | ○ | 共通
service | このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。 | hmpn_cnt_srv=hmpn_cnt_srv，hmpn_cnt_run=hmpn_cnt_run | ○※ | 共通
parallel_count | このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。 | 1 | × | 共通
type | このサービスグループの種別を指定します。 | other | × | 共通
hold | サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。 | N | × | 共通
service_hold | サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。 | N | × | 共通
term_watch_time | ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。 | 30 | × | 共通
hold_recovery | 全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。 | N | × | 共通
receive_from | サービス関数が何を使ってメッセージを受信するかを指定します。 | queue | × | 共通
atomic_update | サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。 | N | × | 共通
node_down_restart | OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。 | N | × | 共通
server_type | サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。 | "betran" | × | 共通
cancel_normal_terminate | このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。 | N | × | 共通
critical | サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。 | N | × | 共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。また，「hmpn_cnt_run=hmpn_cnt_run」は変更できません。

(16)　収納業務受付SPP用ユーザサービス定義（HMpnRdb）

収納業務受付SPP用ユーザサービス定義には，サンプルファイルがあります。サンプルファイルの項目には，定義値を変更できる項目と変更できない項目があります。変更できる項目は，必要に応じて，定義値を変更してください。

サンプルファイルの項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-20　収納業務受付SPP用ユーザサービス定義

項目名
説明
サンプルファイルの値
変更
定義が必要な構成の種類

module
実行形式プログラム名を指定します。
HMpnRdb
×
共通

service_group
サービスグループ名を指定します。
hmpn_rdb_srvgrp
○
共通

service
このサービスグループに属するサービス名とそのサービスを提供するエントリポイント名の組を「サービス名=エントリポイント名」の形式で指定します。
hmpn_npayins_srv=hmpn_npayins_srv，hmpn_npayupd_srv=hmpn_npayupd_srv，hmpn_npayref_srv=hmpn_npayref_srv，hmpn_npaycan_srv=hmpn_npaycan_srv，hmpn_demins_srv=hmpn_demins_srv，hmpn_demupd_srv=hmpn_demupd_srv，hmpn_demref_srv=hmpn_demref_srv，hmpn_demcan_srv=hmpn_demcan_srv，hmpn_kpayref_srv=hmpn_kpayref_srv，hmpn_cpayref_srv=hmpn_cpayref_srv，hmpn_cntref_srv=hmpn_cntref_srv，hmpn_msgref_srv=hmpn_msgref_srv
○※
共通

parallel_count
このサービスグループ内のサービスを並行処理する常駐プロセス数を指定します。
6
○
共通

type
このサービスグループの種別を指定します。
other
×
共通

hold
サービスグループ下のサービスを実行中にサーバプロセスが異常終了した場合，このサービスグループ，またはサービスを閉塞するかどうかを指定します。
N
×
共通

service_hold
サービスグループ下のサービスについて，サービス単位の閉塞管理をするかどうかを指定します。
N
×
共通

term_watch_time
ユーザサーバのサーバプロセスが異常終了した回数を監視する限界経過時間（単位：分）を指定します。
30
×
共通

hold_recovery
全面回復時にサービスグループ，およびサービスの閉塞状態を引き継ぐかどうかを指定します。
N
×
共通

receive_from
サービス関数が何を使ってメッセージを受信するかを指定します。
queue
×
共通

atomic_update
サービスグループのプロセスでトランザクションを発生させるかどうかを指定します。
N
×
共通

node_down_restart
OpenTP1再開始時，該当するユーザサーバを自動起動するかどうかを指定します。
N
×
共通

server_type
サービス関数の呼び出し時，OpenTP1のパラダイムに従うか，XATMIのパラダイムに従うかを指定します。
"betran"
×
共通

cancel_normal_terminate
このユーザサーバで，dcsvstopコマンドでの正常終了を抑止するかどうかを指定します。
N
×
共通

critical
サービスグループを実行中にUAPが異常終了した場合のOpenTP1システムの処置を指定します。
N
×
共通

（凡例）

○：変更できる

×：変更できない

共通：どの構成でも指定する項目

注※

エントリポイント名は，変更できません。

4.3　HiRDBの定義

HiRDBの定義の概要，定義の手順，およびHiRDBの定義項目について説明します。

＜この節の構成＞

4.3.1　HiRDBの定義の概要

4.3.2　HiRDBの定義の手順

4.3.3　HiRDBの定義項目

4.3.1　HiRDBの定義の概要

HiRDBの定義は，テキスト形式の定義ファイルに記述します。ここでは，HA構成でHiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合，およびクラスタ構成の場合に必要な定義項目だけを説明します。

HiRDBの定義ファイルの一覧を次に示します。

表4-21　HiRDBの定義ファイルの一覧

ファイル名 | 定義の種類 | 説明 | サンプルファイルの有無
pdsys | システム共通定義 | 通信サーバfor Billerのシステムの実行環境を定義します。HA構成でHiRDBと通信サーバfor Billerを同一マシン上にセットアップしている場合は，そのHiRDBの環境を定義します。 | ×
pdutsys※ | ユニット制御情報定義 | HA構成でHiRDBと通信サーバを同一マシン上にセットアップしている場合は，HiRDBの環境を定義します。 | ×

（凡例）

×：サンプルファイルがない

注※

HA構成の場合に必要です。

なお，ここで説明する定義項目以外の定義項目については，マニュアル「スケーラブルデータベースサーバ HiRDB システム定義」を参照してください。

4.3.2　HiRDBの定義の手順

HiRDBの定義は，次の手順で行ってください。また，HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合に定義してください。

定義ファイルを作成する
HiRDBの定義には，サンプルファイルがありません。定義ファイルについては「4.3.3　HiRDBの定義項目」を参照してください。

定義ファイルを編集する
必要に応じて，定義ファイルを編集してください。

定義ファイルを所定のディレクトリに格納する

定義ファイルの編集方法，および定義ファイルの格納先については，マニュアル「スケーラブルデータベースサーバ HiRDB システム定義」を参照してください。

4.3.3　HiRDBの定義項目

HiRDBの定義をファイルごとに説明します。なお，各項目については，マニュアル「スケーラブルデータベースサーバ HiRDB システム定義」を参照してください。また，各定義ファイルの記述例については「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」，「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」または「4.9　定義ファイルの記述例（クラスタ構成の場合）」を参照してください。

＜この項の構成＞

(1)　システム共通定義（pdsys）

(2)　ユニット制御情報定義（pdutsys）

(1)　システム共通定義（pdsys）

システム共通定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-22　システム共通定義（HiRDBの定義）

項目名 | 説明 | 定義値 | 定義値の変更 | 定義が必要な構成の種類
pd_ha | 系切り替えを使用するかどうかを指定します。 | use | × | HA※1
pd_lck_wait_timeout | 排他待ち時間を監視する最大時間を秒単位で指定します。 | 任意※2 | ○ | CL
pd_mode_conf | HiRDBの開始方法を指定します。 | MANUAL2 | × | HA※1

（凡例）

○：「説明」欄，および「定義値」欄の条件で，任意の値を指定する

×：必ず「定義値」欄の値を指定する

HA：HA構成の場合，指定する項目

CL：クラスタ構成の場合，指定する項目

注※1

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合のHA構成です。現用系，および予備系のシステムで同じ定義内容にする必要があります。

注※2

「AUTO_START」に「AUTO」を設定している場合，次の計算式で求められる値より大きい値を指定してください。また，「MANUAL」を設定している場合，120（秒）より大きい値を指定してください。

排他待ち限界経過時間（単位：秒）=通信サーバ起動時間（120）+（自動起動する収納機関の数×2）

(2)　ユニット制御情報定義（pdutsys）

ユニット制御情報定義には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず指定してください。表中にない項目については，環境に合わせて定義できます。

表4-23　ユニット制御情報定義

項目名 | 説明 | 定義値 | 定義値の変更 | 定義が必要な構成の種類
pd_ha_acttype | 系切り替えを使用する場合に，サーバモードでの系切り替えを指定します。 | server | × | HA※

（凡例）

×：必ず「定義値」欄の値を指定する

HA：HA構成の場合，指定する項目

注※

HiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合のHA構成です。現用系，および予備系のシステムで同じ定義内容にする必要があります。

4.4　通信サーバシステム定義

通信サーバシステム定義の概要，定義の手順，通信サーバシステム定義ファイルの記述方法，通信サーバシステムの定義項目，および通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権について説明します。

＜この節の構成＞

4.4.1　通信サーバシステム定義の概要

4.4.2　通信サーバシステム定義の手順

4.4.3　通信サーバシステム定義ファイルの記述方法

4.4.4　通信サーバシステム定義の定義項目

4.4.5　通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権

4.4.1　通信サーバシステム定義の概要

通信サーバシステム定義は，通信サーバfor Billerの動作を制御するための定義です。通信サーバシステム定義は，テキスト形式の定義ファイルに記述します。

通信サーバシステム定義には，次の種類があります。通信サーバシステム定義の項目は，通信サーバfor Billerが指定する制限内であれば，すべての項目に任意の値を設定できます。

表4-24　通信サーバシステム定義の種類

定義の種類 | タグ | 説明 | 省略の有無
共通定義 | [COMMON] | 通信サーバシステムの共通定義をします。 | －
文字コード変換機能定義 | [HMPN/CODE] | 通信サーバfor Billerで扱う文字コードセットに関する定義をします。 | －
DB定義 | [HMPN/DB] | データベースに関する定義をします。 | －
HA定義 | [HMPN/HA] | 通信サーバfor BillerをHA構成にする場合に定義します。 | ○
通信サーバfor Biller共通定義 | [HMPN/BL] | 通信サーバfor Billerに関する共通定義をします。 | －
通信サーバfor Biller CUP定義 | [HMPN/BL/CUP] | 業務電文受信CUPに関する定義をします。 | －
障害監視定義 | [HMPN/BL/MON] | 監視プロセスに関する定義をします。 | －
障害監視対象外ユーザサーバ定義 | [HMPN/BL/MON/USERSV] | 監視プロセスとユーザサーバの関係の定義をします。 | ○
通信サーバfor Biller業務系SPP定義 | [HMPN/BL/SRV/（収納機関コード）]※1 | 収納サービスに関する定義をします。この定義は必ず一つ以上定義してください。 | －
収納業務プログラム共通定義 | [HMPN/BL/SRV/（収納機関コード）/COM]※1 | 収納業務プログラムに関する定義をします。収納業務プログラムを通信サーバfor Billerと同じマシンで運用する場合は，省略できます。 | ○
照会収納業務プログラムデフォルト定義 | [HMPN/BL/SRV/（収納機関コード）/REF]※1 | 通信サーバfor Billerの照会SPPが呼び出す収納業務プログラムのSPPに関する定義をします。納付区分ごとに呼び出すSPPを振り分ける場合は，照会収納業務プログラム定義納付区分タグ[HMPN/BL/SRV/（収納機関コード）/REF/（納付区分※2）]に同様の定義をします。※3 | －
消込収納業務プログラムデフォルト定義 | [HMPN/BL/SRV/（収納機関コード）/PAY]※1 | 通信サーバfor Billerの消込SPPが呼び出す収納業務プログラムのSPPに関する定義をします。納付区分ごとに呼び出すSPPを振り分ける場合は，消込収納業務プログラム定義納付区分タグ[HMPN/BL/SRV/（収納機関コード）/PAY/（納付区分※2）]に同様の定義をします。※3 | －
取消収納業務プログラムデフォルト定義 | [HMPN/BL/SRV/（収納機関コード）/CAN]※1 | 通信サーバfor Billerの取消SPPが呼び出す収納業務プログラムのSPPに関する定義をします。納付区分ごとに呼び出すSPPを振り分ける場合は，取消収納業務プログラム定義納付区分タグ[HMPN/BL/SRV/（収納機関コード）/CAN/（納付区分※2）]に同様の定義をします。※3 | －
再送確認収納業務プログラムデフォルト定義 | [HMPN/BL/SRV/（収納機関コード）/RESEND]※1 | 通信サーバfor Billerの再送確認SPPが呼び出す収納業務プログラムのSPPに関する定義をします。納付区分ごとに呼び出すSPPを振り分ける場合は，再送確認収納業務プログラム定義納付区分タグ[HMPN/BL/SRV/（収納機関コード）/RESEND/（納付区分※2）]に同様の定義をします。※3 | －

（凡例）

○：省略できる

－：省略できない

注※1

各収納機関の収納機関コードごとに定義が必要です。

注※2

地方税・地公体料金の場合は，納付区分に，税目・料金番号（3桁）を定義してください。国庫金で収納機関コードが国税庁（00200000）の場合は，納付区分（1～16桁）を定義してください。

注※3

納付区分ごとに振り分ける場合のタグと，振り分けない場合のタグを両方定義すると，振り分ける場合のタグに定義した内容が優先されます。

これらの定義の構成と特長については，「4.1.1　定義の構成と特長」を参照してください。

なお，通信サーバシステム定義では，次のような運用を決定する機能を定義できます。

納付区分ごとへの電文振り分け機能（地方税・地公体料金，国庫金の場合）

対象金融機関の仮想店舗機能

システムの連動起動

＜この項の構成＞

(1)　納付区分ごとへの電文振り分け機能（地方税・地公体料金，国庫金の場合）

(2)　対象金融機関の仮想店舗機能

(3)　システムの連動起動

(1)　納付区分ごとへの電文振り分け機能（地方税・地公体料金，国庫金の場合）

通信サーバfor Billerは，通信サーバシステム定義に定義された各収納機関の各SPPに電文を振り分けます。地方税・地公体料金の場合は，税目・料金番号の種類別に振られた納付区分の各SPPに電文を振り分けます。また，国庫金で収納機関コードが国税庁（00200000）の場合は，納付区分の各SPPに電文を振り分けます。この場合，通信サーバシステム定義の次の定義を指定します。

照会収納業務プログラム定義納付区分タグ
[HMPN/BL/SRV/（収納機関コード）/REF/（納付区分）]

消込収納業務プログラム定義納付区分タグ
[HMPN/BL/SRV/（収納機関コード）/PAY/（納付区分）]

取消収納業務プログラム定義納付区分タグ
[HMPN/BL/SRV/（収納機関コード）/CAN/（納付区分）]

再送確認収納業務プログラム定義納付区分タグ
[HMPN/BL/SRV/（収納機関コード）/RESEND/（納付区分）]

これらの定義で実現される納付区分ごとへの電文の振り分けの仕組みを次に示します。

図4-6　納付区分ごとへの電文振り分けの仕組み

収納機関コードに加えて，納付区分ごとに電文を振り分けられることで，各収納機関で納付区分に合わせたサービスを提供できます。

各定義項目の詳細については，「4.4.4(11)　照会収納業務プログラムデフォルト定義」，「4.4.4(12)　消込収納業務プログラムデフォルト定義」，「4.4.4(13)　取消収納業務プログラムデフォルト定義」，および「4.4.4(14)　再送確認収納業務プログラムデフォルト定義」を参照してください。

(2)　対象金融機関の仮想店舗機能

通信サーバfor Billerでは，対象金融機関情報格納用テーブル，または国庫金対象金融機関情報格納用テーブルに格納できる金融機関情報について，店舗ごとに収納委託契約がある金融機関に対しては店舗ごとの情報登録，また，すべての店舗に収納委託契約がある金融機関に対しては金融機関ごとの情報登録ができます。

これらは，対象金融機関情報格納用テーブル，または国庫金対象金融機関情報格納用テーブルに格納される，金融機関の店舗コードによって実現できます。店舗ごとの情報登録では，対象金融機関情報格納用テーブル，または国庫金対象金融機関情報格納用テーブルに，金融機関の店舗コードを指定します。一方，金融機関ごとの情報登録では，通信サーバシステム定義で定義した仮想店舗コードを対象金融機関情報格納用テーブルに登録します。登録は金融機関情報の変更コマンド（hmpnbnkctl）で行います。

仮想店舗機能での対象金融機関チェックの流れを次に示します。なお，対象金融機関チェックの概要については，「1.6.3(1)　対象金融機関チェック」を参照してください。

図4-7　仮想店舗機能での対象金融機関チェックの流れ

収納委託金融機関の店舗が存在するかどうかをチェックする
MPNセンタから電文を受信したあと，電文の金融機関情報のうち，次の情報を基に，対象の店舗が存在するかどうかをチェックします。

地方税・地公体料金，一般料金の場合
金融機関コード，店舗コード

国庫金の場合
歳入代理店金融機関コード，店舗コード

収納委託金融機関の仮想店舗で処理できるかどうかをチェックする
対象の店舗からの電文ではなかった場合，通信サーバfor Billerに定義されている仮想店舗コードがDBに登録されている店舗コードと一致するかどうかをチェックします。一致した場合，仮想店舗で処理できると判断します。

収納委託金融機関の店舗で処理できるかどうかをチェックする
電文の金融機関情報のうち，次の情報を基に，対象の店舗で処理できるかどうかをチェックします。

地方税・地公体料金の場合
金融機関コード，店舗コード，チャネル区分，および税目・料金番号

一般料金の場合
金融機関コード，店舗コード，およびチャネル区分

国庫金の場合
歳入代理店金融機関コード，店舗コード，チャネル区分，および納付区分

収納委託金融機関との契約が有効期限内かどうかをチェックする
最後に，電文の金融機関情報が，有効期限内の情報かどうかをチェックし，MPNセンタに正常応答電文，またはエラー応答電文を送信します。

仮想店舗コードは，次の項目で定義します。

通信サーバfor Biller共通定義の「V_BRANCH_CODE」

通信サーバfor Biller業務系SPP定義「V_BRANCH_CODE」

各定義項目の詳細については，「4.4.4(5)　通信サーバfor Biller共通定義」，および「4.4.4(9)　通信サーバfor Biller業務系SPP定義」を参照してください。

注意

MPNセンタからファイル転送で受信した伝送ファイルに対して，消込情報ファイルの変換コマンド（hmpnpayfile）を実行した場合は，伝送ファイル内の金融機関店舗コードがALL0かどうかを確認したあと，対象金融機関について同様の流れでチェックします。この場合，MPNセンタに応答電文を送信するのではなく，変換後の消込情報ファイルにリターン情報を設定します。消込情報ファイルの変換の場合の流れを次に示します。

図4-8　仮想店舗機能での対象金融機関チェックの流れ（消込情報ファイルの変換の場合）

消込情報ファイルの変換については，「8.4.4　消込情報ファイルの変換」を参照してください。

(3)　システムの連動起動

収納機関サービスの起動および通信サーバfor Billerの開局は，通信サーバfor Billerの起動と連動して起動・開局できます。連動して起動・開局するためには，定義に自動起動（自動開局）を指定します。

連動起動するために必要な定義について，次に示します。

表4-25　通信サーバfor Billerの起動と連動起動するために必要な定義

連動するプロセス
連動起動するための定義
推奨値

OpenTP1の起動と
通信サーバfor Billerの起動
BL_AUTO_START="AUTO"
HA構成の場合：どちらでもよい

クラスタ構成の場合：MANUAL

通信サーバfor Billerと
収納機関サービスの起動
AUTO_START="AUTO"
AUTO

通信サーバfor Billerと
通信サーバfor Billerの開局
AUTO_OPEN="AUTO"
MANUAL

自動起動（自動開局）の詳細については，「8.2.2　通信サーバfor Billerの起動」，「8.2.3　収納機関サービスの起動」および「8.2.4　通信サーバfor Billerの開局」を参照してください。

なお，各定義については，「4.4.4　通信サーバシステム定義の定義項目」を参照してください。

4.4.2　通信サーバシステム定義の手順

通信サーバシステム定義は，次の手順で行ってください。

サンプルファイル（HMpnSvConf.online）を任意のディレクトリにコピーする
サンプルファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples
コピーしたファイルを定義ファイルとして使用してください。

ファイルのアクセス権を変更する
コピーした定義ファイルに，書き込み権限を追加してください。

定義ファイルを編集する
「4.4.3　通信サーバシステム定義ファイルの記述方法」を参照して，定義ファイルを編集してください。

手順3で指定したディレクトリおよびファイルのアクセス権を確認する
通信サーバシステム定義に指定したディレクトリおよびファイルのアクセス権を確認してください。設定するアクセス権については，「4.4.5　通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権」を参照してください。

定義ファイルをマージする
通信サーバBaseについての定義と手順3で編集した定義を合わせて，一つのファイルにしてください。通信サーバBaseについての定義については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

ファイル名を変更する
手順5で作成したファイルの名前を「HMpnSvConf」に変更してください。

定義ファイルをチェックする
定義チェックコマンド（hmpndefchk）を実行して，定義ファイルの内容をチェックしてください。
定義チェックコマンドについては，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

定義ファイル（HMpnSvConf）を所定のディレクトリに格納する
定義ファイルは，次のディレクトリに格納してください。
（通信サーバfor Billerセットアップディレクトリ）/conf

ファイル初期化コマンド（hmpnblinit）を実行する
ファイル初期化コマンドについては，「10.3　コマンドの詳細　hmpnblinit（ファイル初期化）」を参照してください。

注意

定義ファイルの変更は，必ず通信サーバが停止している状態で行ってください。

4.4.3　通信サーバシステム定義ファイルの記述方法

定義ファイルの記述形式，および記述時の注意事項について説明します。

＜この項の構成＞

(1)　記述形式

(2)　注意事項

(1)　記述形式

定義ファイルは，次の形式で記述します。

[タグ]
定義名="定義値"  #コメント
　　　：
定義名="定義値"

[タグ]
定義名="定義値"  #コメント
　　　：
定義名="定義値"

タグ

定義ファイル中では，「[」で始まり，「]」で終わる行が，タグとして扱われます。定義ファイルの項目は，定義の内容によって分類されています。各項目は，決められたタグの下に記述してください。定義項目の分類については，「4.4.4　通信サーバシステム定義の定義項目」を参照してください。

セクション

あるタグから，次のタグの前までの1行以上の定義をセクションといいます。

定義名

定義ファイルの項目は，定義名ごとに記述します。定義ファイル中では，「[」で始まり，「]」で終わる行以外が，定義名が含まれる行として扱われます。定義名のあとには，必ず「=」を記述してください。

定義値

定義名に対する値を設定します。定義ファイル中では，「=」のあとに記述します。定義値には，文字列型と数字型の値を指定できます。定義値が文字列の場合は，必ず「""」で囲んでください。定義値が数字の場合は，「""」で囲む必要はありません。また，「推奨値」欄の「,」は実際に定義する場合は不要です。

コメント

定義以外に補足する情報がある場合に記述します。コメントは，「#」のあとに記述してください。

(2)　注意事項

定義ファイルを記述するときは，次の点に注意してください。

定義ファイル全体について

1行に記述できる文字列は，2,048文字までです。一つの定義が2,048文字を超える場合は，「,」で区切って，複数行に分けてください。

最後の行の末尾では，必ず改行してください。

マルチバイトコードを含む定義は記述できません。ただし，コメントの場合は記述できます。

タグについて

同じセクション内に，同じタグ名を記述できません。

タグ名を記述した場合は，定義の省略はできません。

[COMMON]タグは，必ず定義ファイルの先頭に記述してください。[COMMON]タグについては，「4.4.4　通信サーバシステム定義の定義項目」を参照してください。

定義名について

一つのセクションの中に，同じ定義名を複数記述することはできません。

定義値について

値には，指定属性値以外の値（記号，スペース，タブなど）を使用しないでください。

4.4.4　通信サーバシステム定義の定義項目

通信サーバシステム定義を定義の種類ごとに説明します。

また，各定義ファイルの記述例については「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」，「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」または「4.9　定義ファイルの記述例（クラスタ構成の場合）」を参照してください。

＜この項の構成＞

(1)　共通定義

(2)　文字コード変換機能定義

(3)　DB定義

(4)　HA定義

(5)　通信サーバfor Biller共通定義

(6)　通信サーバfor Biller CUP定義

(7)　障害監視定義

(8)　障害監視対象外ユーザサーバ定義

(9)　通信サーバfor Biller業務系SPP定義

(10)　収納業務プログラム共通定義

(11)　照会収納業務プログラムデフォルト定義

(12)　消込収納業務プログラムデフォルト定義

(13)　取消収納業務プログラムデフォルト定義

(14)　再送確認収納業務プログラムデフォルト定義

(1)　共通定義

共通定義の項目を次に示します。共通定義は，[COMMON]タグのセクションに記述します。なお，定義内の項目は，必ず記述してください。

表4-26　共通定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
CENTER_CODE | センタコード | <英字の大文字，記号※，数字>（10桁） | － | 自センタコードを指定します。この定義値を基に，通信サーバfor Billerは共通ソフトウェアのキューマネージャー名を決定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

注※

使用できる記号については，MPNの仕様に従ってください。

(2)　文字コード変換機能定義

文字コード変換機能定義の項目を次に示します。文字コード変換機能定義は，[HMPN/CODE]タグのセクションに記述します。なお，定義内の項目は，必ず記述してください。

表4-27　文字コード変換機能定義

定義名
定義内容
定義値の条件
推奨値
説明
定義が必要な構成の種類

OWN_NAME
動作環境で使用する文字コードセット名
シフトJISコードを示すalias名※

AIX 5Lの場合
IBM-943

HP-UXの場合
sjis

通信サーバfor Billerで使用する文字コードセット名を指定します。使用する文字コードセットは，シフトJISコードです。
共通

MPN_NAME
MPNセンタで使用する文字コードセット名
JISコードを示すalias名※

AIX 5Lの場合
JISX0208.1983-GL

HP-UXの場合
jis

MPN仕様上の文字コードの規定を満たす日本語コードセットを指定します。使用する文字コードセットは，JISコードです。
共通

（凡例）

共通：どの構成でも指定する項目

注※

適用OSがAIX 5Lの場合，定義値には，AIX 5Lがサポートするコードセット・コンバーターによって相互に変換できる日本語コードセットを指定してください。コードセット・コンバーターについては，AIX 5Lのマニュアルを参照してください。

適用OSがHP-UXの場合，定義値には，HP-UXのシステムが保有するconfig.iconvファイルに定義されるalias名を指定します。config.iconvファイルは，/usr/lib/nls/iconv/に格納されています。

alias名は，HP-UXに付属している日本語システム環境をインストールすると，追加されます。この中から環境に合わせて，文字コードセットを選択してください。なお，alias名，config.iconvファイルおよび文字コードセットの追加方法は，HP-UXの仕様に基づきます。

(3)　DB定義

DB定義の項目を次に示します。DB定義は，[HMPN/DB]タグのセクションに記述します。なお，この定義は省略できます。定義を省略した場合は，推奨値が定義値として設定されます。

表4-28　 DB定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
CONNECT_RETRY_TIMES | DB再接続リトライ回数 | <符号なし整数>((0～2,048)) | 15 | DBとの接続にエラーが発生した場合に，接続をリトライする回数を指定します。0を指定した場合は，リトライしません。 | 共通
CONNECT_RETRY_INTERVAL | DB接続リトライ間隔（単位：秒） | <符号なし整数>((1～10)) | 1 | DBとの接続がエラーになった場合に接続をリトライする間隔を指定します。 | 共通
RDBMS※ | 通信サーバfor Billerで使用するDB | <文字列>{HiRDB|Oracle} | － | 通信サーバfor Billerで使用するDBがHiRDBの場合，HiRDBを指定します。また，通信サーバfor Billerで使用するDBがORACLEの場合，Oracleを指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

注※

この項目は省略できます。省略した場合は，HiRDBが定義値として設定されます。

また，通信サーバfor Biller共通定義の「BL_ENV」には，この定義項目に指定したDBの環境変数を指定してください。「BL_ENV」の指定方法については，「(5)　通信サーバfor Biller共通定義」を参照してください。また，ORACLEの場合の「BL_ENV」の指定方法については，マニュアル「Hitachi Multi Payment Network Extensible Database Option for Biller」を参照してください。

(4)　HA定義

HA定義の項目を次に示します。HA定義は[HMPN/HA]タグのセクションに記述します。この定義は，HA構成の場合に指定します。この定義を指定した場合は，クラスタの定義はできません。また，この定義を指定する場合，「HA_KIND」および「SV_GRP」は，必ず両方指定してください。

表4-29　HA定義

定義名
定義内容
定義値の条件
推奨値
説明
定義が必要な構成の種類

HA_KIND
通信サーバfor BillerおよびHiRDBの構成の種別
{SRV|GRP}
－

通信サーバfor Biller単独でのHA構成の場合，通信サーバfor BillerとHiRDBを別のマシンにセットアップするとき，「SRV」を指定します。

通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合，「GRP」を指定します（HiRDBの構成は任意）。※1

HA

SV_GRP※2
HAモニタの監視対象名
<アルファベットおよび数字>（1～8文字）
ただし，先頭にはアルファベットだけを指定できます。
－

「HA_KIND」に「SRV」を指定した場合，OpenTP1を監視対象サーバとするサーバの識別名を指定します。

「HA_KIND」に「GRP」を指定した場合，監視対象サーバをグループ化した，サーバグループ名を指定します。

HA

（凡例）

－：該当なし

HA：HA構成の場合，指定する項目

注※1

通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合は，通信サーバBaseのファイル転送機能HA定義[HMPN/FTHA]だけ記述する必要があります。

通信サーバfor Biller単独でのHA構成で，通信サーバBaseおよび通信サーバfor Billerを切り替える構成の場合は，通信サーバBaseのファイル転送機能HA定義[HMPN/FTHA]の記述をしないでください。通信サーバBaseのファイル転送機能HA定義については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

注※2

通信サーバfor Billerが監視するプロセスが障害によって停止した場合，この項目にサーバ識別名，またはグループ名を設定し，HAモニタの系切り替えコマンド（monswap）を実行します。通信サーバfor Billerが監視するプロセスとは，OpenTP1監視プロセス，制御電文CUP監視プロセス，業務電文受信CUP監視プロセス，SPP障害監視プロセス，および共通ソフトウェアです。

(5)　通信サーバfor Biller共通定義

通信サーバfor Biller共通定義の項目を次に示します。通信サーバfor Biller共通定義は，[HMPN/BL]タグのセクションに記述します。

表4-30　通信サーバfor Biller共通定義

定義名
定義内容
定義値の条件
推奨値
説明
定義が必要な構成の種類

TRC_FILE_SIZE
プロセス別トレースのファイルサイズ（単位：バイト）
<符号なし整数>((4,096～2,147,483,647))
11,000,000
一つのプロセス別トレースファイルの最大サイズを指定します。
共通

TRC_FILE_NUM
プロセス別トレースファイル数
<符号なし整数>((1～16))
6※1
プロセス別トレースのファイル数を指定します。
共通

TRC_LEVEL
トレースレベル
<符号なし整数>{0|10|20|30}
10※2
トレース出力レベルを指定します。指定方法については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。
共通

TRC_PRC_LEVEL
プロセス別トレースしきい値
<符号なし整数>{0|10|20|30}
0※2
プロセス別トレースのしきい値を指定します。指定方法については，マニュアル「Hitachi Multi Payment Network　communications server Base」を参照してください。
共通

TRC_SHM_LEVEL
統合トレースのしきい値
<符号なし整数>{0|10|20|30}
0※2
統合トレースのしきい値を指定します。指定方法については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。
共通

TARGET_HOST
自ホスト名・ポート番号
ホスト名：<識別子>（1～63文字），ポート番号：<符号なし整数>((5,001～65,535))
－
自ホストのホスト名とTP1/Server Base定義のネームポート番号を「ホスト名：ポート番号」の形式で指定します。
共通

COUNT_USERSV
収納カウンタ情報取得SPPのユーザサーバ名
<識別子>（1～8文字）
－※3
収納カウンタ情報取得SPPのユーザサーバ名を指定します。
共通

COUNT_SERVICEGRP
収納カウンタ情報取得SPPのサービスグループ名
<識別子>（1～31文字）
－※3
収納カウンタ情報取得SPPのサービスグループ名を指定します。
共通

COUNT_SERVICE
収納カウンタ情報取得SPPのサービス名
<識別子>（1～31文字）
－※3
収納カウンタ情報取得SPPのサービス名を指定します。
共通

COUNT_WAIT_TIME
収納カウンタ情報取得コマンド待ち時間（単位：秒）
<符号なし整数>((7～15))
10※4
収納カウンタ情報取得コマンド（hmpncntget）の実行待ち時間を指定します。
共通

RDB_USERSV
収納業務受付SPPのユーザサーバ名
<識別子>(1～8文字)
－※3
収納業務受付SPPのユーザサーバ名を指定します。
共通

BL_AUTO_START※5
自動起動
<文字列>{AUTO|MANUAL}
MANUAL※6
OpenTP1起動時に，自動的に通信サーバfor Billerを起動する場合は，「AUTO」，手動起動する場合は「MANUAL」を指定します。
共通

AUTO_OPEN※5
自動開局
<文字列>{AUTO|MANUAL}
MANUAL※6，※7
通信サーバfor Biller起動時に，自動開局する場合は「AUTO」，手動開局する場合は「MANUAL」を指定します。
共通

OPEN_RETRY_TIMES※5
開始要求電文再送回数
<符号なし整数>((0～5))
1
開始要求の再送回数を指定します。「0」を指定した場合，「OPEN_RETRY_INTERVAL」は無効になります。
共通

OPEN_RETRY_INTERVAL※5
開始要求送出間隔タイマ（単位：秒）
<符号なし整数>((0～290))
10
開始要求がタイムアウトになった場合の再送間隔を指定します。
共通

MPN_BL_SOFT_ENV_FILE
共通ソフトウェアの環境設定ファイル（オンライン電文用）
<パス名>（1～PATH_MAX文字）
－
共通ソフトウェアの環境設定ファイル（オンライン電文用）を絶対パスで指定します。
共通

MPN_BL_SOFT_MQ_STT_SH
共通ソフトウェア起動コマンド
<パス名>（1～PATH_MAX文字）
－
共通ソフトウェアの起動コマンドを絶対パスで指定します。
共通

MPN_BL_SOFT_MQ_STP_SH
共通ソフトウェア停止コマンド
<パス名>（1～PATH_MAX文字）
－
共通ソフトウェアの停止コマンドを絶対パスで指定します。
共通

RAW_BL_STAT
状態管理ファイル用ロウ論理ボリューム名
<パス名>（1～PATH_MAX文字）
－※8
状態管理ファイル用ロウ論理ボリューム名を絶対パスで指定します。
共通

RAW_WORKPRC_STAT
業務系SPP状態ファイル用ロウ論理ボリューム名
<パス名>（1～PATH_MAX文字）
－※8
業務系SPP状態ファイル用ロウ論理ボリューム名を絶対パスで指定します。
共通

CHANNEL_NAME
共通ソフトウェアのキューマネージャーのチャネル名
<文字列>
半角文字だけ使用できます。
－
共通ソフトウェアのキューマネージャー（オンライン電文用）を作成した際に指定したチャネル名を「CHANNEL_NAME="送信チャネル1:受信チャネル1,送信チャネル2:受信チャネル2"」の形式で指定します。指定できるチャネルは，最大100系です。なお，最低でも1系分の送受信チャネルを指定する必要があります。
文字列を区切る場合は，「:」または「,」を使用してください。※9
共通

BL_ENV
ユーザサーバ使用の共通環境変数
<文字列>
－
ユーザサーバで使用する共通の環境変数を「BL_ENV="環境変数名=環境変数値"」の形式で指定します。※10
環境変数「PDHOST」，「PDNAMEPORT」および「PDUSER」は必ず指定してください。※11
文字列を区切る場合は，「,」を使用してください。環境変数名の前後にSPACEを記述しないでください。また，複数行になる場合，各行を「""」で囲んでください。なお，TP1/Server BaseおよびTP1/Client/Wの環境変数は指定しないでください。
AIX 5Lの場合，環境変数「PSALLOC=early」および環境変数「NODISCLAIM=true」を指定するとページ不足によるプロセス消滅を防止できます。
エラー検出時収納業務プログラム呼び出し機能を使用する場合は，環境変数「HMPN_ERRSEND=YES」を指定してください。
納付区分エラー変換機能を使用する場合は，環境変数「HMPN_PAY_CLSCNV=YES」を指定してください。
共通

CLUSTER_MODE
クラスタ構成指定
<文字列>{Y|N}
－※12
クラスタ構成で構築するかどうかを指定します。クラスタ構成で構築する場合は「Y」，構築しない場合は「N」を指定します。
CL

V_BRANCH_CODE
収納機関共通の仮想店舗コード
<符号なし整数>（6桁，および8桁）
－
すべての収納機関で有効な仮想店舗コードを指定します。※13
対象金融機関情報格納用テーブルに登録した仮想店舗コードを「金融機関コード（8桁）:仮想店舗コード（6桁）」の形式で指定してください。
文字列を区切る場合は，「:」または「,」を使用してください。※14
共通

（凡例）

－：該当なし

CL：クラスタ構成の場合，指定する項目

共通：どの構成でも指定する項目

注※1

見積もり方法については，「4.6.1　トレースファイルの見積もり」を参照してください。システム構築時に，テストを実施する場合を除き，プロセス別トレースファイル数は2以上を指定してください。

注※2

次のような場合を除き，トレース出力レベル，プロセス別トレースのしきい値，および統合トレースのしきい値は推奨値を指定してください。

・システム構築時に，テストを実施する場合

・トラブルシュート時に，詳細な障害情報が必要になった場合

トレース出力レベル，プロセス別トレースしきい値および統合トレースのしきい値の詳細については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

注※3

ユーザサーバ名，サービスグループ名，およびサービス名は，TP1/Server Baseごとにユニークな値を指定してください。

注※4

定義値に10秒加算した値で時間監視をします。

注※5

この項目は省略できます。省略した場合は，推奨値が定義値として設定されます。

注※6

「BL_AUTO_START」および「AUTO_OPEN」に「AUTO」を設定している場合，「OPEN_RETRY_TIMES」と「OPEN_RETRY_INTERVAL」に設定した値によって，最大で次の計算式で求められる値（単位：秒）の間，開局処理を実行します。また，通信サーバfor Biller業務系SPP定義の「AUTO_START」に「AUTO」を設定している場合は，次の計算式で求められる値に収納機関サービスの起動時間を加えた時間，開局処理を実行します。

開局処理に掛かる時間（単位：秒）＝開始応答電文待ち時間（10）+「OPEN_RETRY_TIMES」×「OPEN_RETRY_INTERVAL」

開始応答電文待ち時間は，固定値（10）です。なお，OpenTP1のシステム環境定義（env）の「system_init_watch_time」に，この計算式で求められる値よりも大きい値を設定してください。OpenTP1の定義については，「4.2.4　OpenTP1の定義項目」を参照してください。

注※7

クラスタ構成の場合，すべての通信サーバで「AUTO_OPEN」に同じ定義値を指定してください。

注※8

「RAW_BL_STAT」と「RAW_WORKPRC_STAT」には，異なるロウ論理ボリューム名を指定してください。また，通信サーバBaseで使用するロウ論理ボリューム名は指定できません。

注※9

チャネル名を複数行に分けて指定する場合は，次のように指定してください。

CHANNEL_NAME="TO.N0000000000:TO.N9999900000,",
            "TO.N0000000001:TO.N9999900000"

注※10

個別の収納機関だけで有効な環境変数を指定する場合は，通信サーバfor Biller業務系SPP定義の「SRV_ENV」に指定してください。

通信サーバfor Biller共通定義の「BL_ENV」と通信サーバfor Biller業務系SPP定義の「SRV_ENV」の両方を指定した場合，通信サーバfor Biller業務系SPP定義の「SRV_ENV」に指定した環境変数が有効になります。

通信サーバfor Biller業務系SPP定義については，「(9)　通信サーバfor Biller業務系SPP定義」を参照してください。

注※11

HiRDBの環境変数の指定例を次に示します。

BL_ENV="PDHOST=host_DB,",
        "PDNAMEPORT=20000,PDUSER='"mpnha"/"mpnha"'"

なお，HA構成でHiRDBと通信サーバfor Billerを同一マシン上にセットアップする場合は，「PDHOST」にHiRDB用エイリアスIPのホスト名を指定してください。また，この指定の詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

注※12

この項目は省略できます。省略した場合は，「N」が定義値として設定されます。

「CLUSTER_MODE」に「Y」を指定した場合，OpenTP1のシステム共通定義（betranrc）の「all_node」を必ず指定してください。

指定方法については，「4.2.4(3)　システム共通定義（betranrc）」を参照してください。

また，この場合，環境変数DCHOSTを必ず指定してください。環境変数DCHOSTについては，「3.4.4　通信サーバfor Billerの環境設定」および「4.2.4(1)　システム環境定義（env）」を参照してください。

なお，クラスタ構成を指定した場合，通信サーバfor BillerのHA定義および通信サーバBaseのファイル転送機能HA定義を指定できません。ファイル転送機能HA定義については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

注※13

個別の収納機関だけで有効な仮想店舗コードを指定する場合は，通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」に指定してください。

通信サーバfor Biller共通定義の「V_BRANCH_CODE」と通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」の両方を指定した場合，通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」に指定した仮想店舗コードが有効になります。

通信サーバfor Biller業務系SPP定義については，「(9)　通信サーバfor Biller業務系SPP定義」を参照してください。

注※14

仮想店舗コードを複数行に分けて指定する場合は，次のように指定してください。

V_BRANCH_CODE="00000001:000000,",
            "00000002:000000"

金融機関コードは1,000個まで指定できますが，一つの金融機関コードで指定できる仮想店舗コードは一つだけです。二つ以上指定すると，定義チェックでエラーになります。

(6)　通信サーバfor Biller CUP定義

通信サーバfor Biller CUP定義の項目を次に示します。通信サーバfor Biller CUP定義は，[HMPN/BL/CUP]タグのセクションに記載します。なお，定義内の項目は，必ず記述してください。

表4-31　通信サーバfor Biller CUP定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
CUP_COUNT | 業務電文受信CUP起動数 | <符号なし整数>((1～500)) | 12※ | 起動する業務電文受信CUP数を指定します。 | 共通

（凡例）

共通：どの構成でも指定する項目

注※

環境に合わせて設定してください。

(7)　障害監視定義

障害監視定義の項目を次に示します。障害監視定義は，[HMPN/BL/MON]タグのセクションに記載します。なお，定義内の項目は，すべて記述してください。

表4-32　障害監視定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
CTLCUP_WATCH_TIMER | 制御電文受信CUP監視間隔（単位：秒） | <符号なし整数>((1～600)) | 30※ | 制御電文受信CUPの異常終了の監視間隔を指定します。 | 共通
CTLCUP_WATCH_COUNT | 制御電文受信CUP再起動回数（単位：回） | <符号なし整数>((1～10)) | 3※ | 制御電文受信CUPの異常終了からの再起動回数を指定します。 | 共通
CTLCUP_TERM_WATCH_TIME | 連続異常終了限界経過時間（単位：分） | <符号なし整数>((0～60)) | 10※ | 制御電文受信CUPの連続異常終了の限界経過時間を指定します。 | 共通
BUSCUP_WATCH_TIMER | 業務電文受信CUP監視間隔（単位：秒） | <符号なし整数>((1～600)) | 30※ | 業務電文受信CUPの異常終了の監視間隔を指定します。 | 共通
BUSCUP_WATCH_COUNT | 業務電文受信CUP再起動回数（単位：回） | <符号なし整数>((1～10)) | 3※ | 業務電文受信CUPの異常終了からの再起動回数を指定します。 | 共通
BUSCUP_TERM_WATCH_TIME | 連続異常終了限界経過時間（単位：分） | <符号なし整数>((0～60)) | 10※ | 業務電文受信CUPの連続異常終了の限界経過時間を指定します。 | 共通
OPENTP1_WATCH_TIMER | OpenTP1監視間隔（単位：秒） | <符号なし整数>((1～600)) | 30 | OpenTP1の未起動状態の監視間隔を指定します。 | 共通
OPENTP1_WATCH_COUNT | OpenTP1監視回数（単位：回） | <符号なし整数>((1～120)) | 6 | OpenTP1の未起動状態の監視回数を指定します。 | 共通

（凡例）

共通：どの構成でも指定する項目

注※

連続異常終了限界経過時間は，次の値よりも大きな値を指定してください。次の値よりも小さい場合は，連続異常監視ができません。

監視間隔×再起動回数

なお，連続異常終了限界経過時間に0を指定した場合は，連続異常監視を行いません。そのため，再起動回数経過後に，通信サーバfor Billerが停止されます。

(8)　障害監視対象外ユーザサーバ定義

監視対象外ユーザサーバ定義の項目を次に示します。障害監視の対象外にするサーバを，「HMPN/BL/MON/USERSV」タグのセクションに記載します。対象となるユーザサーバ名は，通信サーバfor Billerが提供するSPP名です。また，定義名はUSERSVn（n：<符号なし整数>((1～（監視対象外にするユーザサーバ名の数）))）とし，連番で列挙してください。これ以外の定義名にした場合は，障害対象外となりません。なお，この定義は省略できます。

表4-33　障害監視対象外ユーザサーバ定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
USERSV1 | 監視対象外ユーザサーバ名1 | <識別子>(1～8文字) | － | 障害監視での監視対象外とするSPPのユーザサーバ名1を指定します。 | 共通
USERSV2 | 監視対象外ユーザサーバ名2 | <識別子>(1～8文字) | － | 障害監視での監視対象外とするSPPのユーザサーバ名2を指定します。 | 共通
： | ： | ： | ： | ： | ：
USERSVn | 監視対象外ユーザサーバ名n | <識別子>(1～8文字) | － | 障害監視での監視対象外とするSPPのユーザサーバ名nを指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

(9)　通信サーバfor Biller業務系SPP定義

通信サーバfor Biller業務系SPP定義の項目を次に示します。通信サーバfor Biller業務系SPP定義は，収納機関コード単位で指定し，[HMPN/BL/SRV/（収納機関コード）]タグのセクションに記述します。タグ内の（収納機関コード）には，各収納機関の収納機関コードを指定してください。

なお，この定義は，[HMPN/BL]タグ下に一つ以上定義してください。

表4-34　通信サーバfor Biller業務系SPP定義

定義名
定義内容
定義値の条件
推奨値
説明
定義が必要な構成の種類

AUTO_START
収納機関サービスの自動起動
<文字列>{AUTO|MANUAL}
AUTO※1
通信サーバfor Billerの起動と同時に，業務系SPPを自動起動させるかどうかを指定します。
共通

PAY_TYPE
納付金区分
<文字列>{01|02|03}
－※2
一般料金の場合「01」，地方税・地公体料金の場合「02」，国庫金の場合「03」を指定します。
共通

REF_USERSV
照会SPPのユーザサーバ名
<識別子>（1～8文字）
－※3
照会SPPのユーザサーバ名を指定します。
共通

REF_SERVICEGRP
照会SPPのサービスグループ名
<識別子>（1～31文字）
－※3
照会SPPのサービスグループ名を指定します。
共通

REF_SERVICE
照会SPPのサービス名
<識別子>（1～31文字）
－※3
照会SPPのサービス名を指定します。
共通

PAY_USERSV
消込SPPのユーザサーバ名
<識別子>（1～8文字）
－※3
消込SPPのユーザサーバ名を指定します。
共通

PAY_SERVICEGRP
消込SPPのサービスグループ名
<識別子>（1～31文字）
－※3
消込SPPのサービスグループ名を指定します。
共通

PAY_SERVICE
消込SPPのサービス名
<識別子>（1～31文字）
－※3
消込SPPのサービス名を指定します。
共通

CAN_USERSV
取消SPPのユーザサーバ名
<識別子>（1～8文字）
－※3
取消SPPのユーザサーバ名を指定します。
共通

CAN_SERVICEGRP
取消SPPのサービスグループ名
<識別子>（1～31文字）
－※3
取消SPPのサービスグループ名を指定します。
共通

CAN_SERVICE
取消SPPのサービス名
<識別子>（1～31文字）
－※3
取消SPPのサービス名を指定します。
共通

RESEND_USERSV
再送確認SPPのユーザサーバ名
<識別子>（1～8文字）
－※3
再送確認SPPのユーザサーバ名を指定します。
共通

RESEND_SERVICEGRP
再送確認SPPのサービスグループ名
<識別子>（1～31文字）
－※3
再送確認SPPのサービスグループ名を指定します。
共通

RESEND_SERVICE
再送確認SPPのサービス名
<識別子>（1～31文字）
－※3
再送確認SPPのサービス名を指定します。
共通

SRV_ENV
ユーザサーバ使用の共通環境変数
<文字列>
－
ユーザサーバで使用する共通の環境変数を「SRV_ENV="環境変数名=環境変数値"」の形式で指定します。※4
文字列を区切る場合は，「,」を使用してください。環境変数名の前後にSPACEを記述しないでください。また，複数行になる場合，各行を「""」で囲んでください。なお，TP1/Server BaseおよびTP1/Client/Wの環境変数は指定しないでください。
エラー検出時収納業務プログラム呼び出し機能を使用する場合は，環境変数「HMPN_ERRSEND=YES」を指定してください。
共通

V_BRANCH_CODE
収納機関別の仮想店舗コード
<符号なし整数>（6桁，および8桁）
－
該当する収納機関だけで有効な仮想店舗コードを指定します。※5
対象金融機関情報格納用テーブルに登録した仮想店舗コードを「金融機関コード（8桁）:仮想店舗コード（6桁）」の形式で指定してください。
文字列を区切る場合は，「:」または「,」を使用してください。※6
共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

注※1

この項目は省略できます。省略した場合は，推奨値が定義値として設定されます。

注※2

この項目は省略できます。省略した場合は，地方税・地公体料金の「02」が定義値として設定されます。

注※3

ユーザサーバ名，サービスグループ名，およびサービス名は，TP1/Server Baseごとにユニークな値を指定してください。

注※4

すべての収納機関で有効な環境変数を指定する場合は，通信サーバfor Biller共通定義の「BL_ENV」に指定してください。

通信サーバfor Biller共通定義の「BL_ENV」と通信サーバfor Biller業務系SPP定義の「SRV_ENV」の両方を指定した場合，通信サーバfor Biller業務系SPP定義の「SRV_ENV」に指定した環境変数が有効になります。

なお，通信サーバfor Biller業務系SPP定義の「SRV_ENV」を省略した場合は，通信サーバfor Biller共通定義の「BL_ENV」に指定した環境変数が有効になります。

通信サーバfor Biller共通定義については，「(5)　通信サーバfor Biller共通定義」を参照してください。

注※5

すべての収納機関で有効な仮想店舗コードを指定する場合は，通信サーバfor Biller共通定義の「V_BRANCH_CODE」に指定してください。

通信サーバfor Biller共通定義の「V_BRANCH_CODE」と通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」の両方を指定した場合，通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」に指定した仮想店舗コードが有効になります。

なお，通信サーバfor Biller業務系SPP定義の「V_BRANCH_CODE」を省略した場合は，通信サーバfor Biller共通定義の「V_BRANCH_CODE」に指定した仮想店舗コードが有効になります。

通信サーバfor Biller共通定義については，「(5)　通信サーバfor Biller共通定義」を参照してください。

注※6

仮想店舗コードを複数行に分けて指定する場合は，次のように指定してください。

V_BRANCH_CODE="00000001:000000,",
            "00000002:000000"

金融機関コードは1,000個まで指定できますが，一つの金融機関コードで指定できる仮想店舗コードは一つだけです。二つ以上指定すると，定義チェックでエラーになります。

(10)　収納業務プログラム共通定義

収納業務プログラム共通定義の項目を次に示します。収納業務プログラム共通定義は，[HMPN/BL/SRV/（収納機関コード）/COM]タグのセクションに記述します。タグ内の（収納機関コード）には，各収納機関の収納機関コードを指定してください。なお，この定義は省略できます。定義を省略した場合，[HMPN/BL]タグ下の「TARGET_HOST」の指定値が，この定義の定義値として適用されます。ただし，「HOST_NAME」および「NAME_PORT」のうち，一つだけを省略することはできません。

表4-35　収納業務プログラム共通定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
RPC_KIND | 特定の収納業務プログラムの呼び出し | <文字列>{CALL|CALLTO} | －※ | 収納業務プログラムとの通信で特定の収納業務プログラムを使用するかどうかを指定します。クラスタ構成の場合，CALLを推奨します。RPC_KINDによる電文の振り分けについては，「4.1.2(2)　クラスタ構成の定義の特長」を参照してください。 | 共通
HOST_NAME | 収納業務プログラムのホスト名 | <識別子>（1～63文字） | － | 収納業務プログラムが稼働するTP1/Server Baseの定義に定義されたホスト名を指定します。 | 共通
NAME_PORT | 収納業務プログラムのポート番号 | <符号なし整数>((5,001～65,535)) | － | 収納業務プログラムが稼働するTP1/Server Baseの定義に定義されたネームポート番号を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

注※

この項目を省略した場合，「CALLTO」が定義値として設定されます。この場合，通信サーバfor Biller共通定義の「TARGET_HOST」に指定したホスト名およびポート番号が有効になります。また，「CALL」を指定した場合，「HOST_NAME」および「NAME_PORT」に指定したホスト名およびポート番号は無効になります。

なお，クラスタ構成以外の場合，または同一ホスト上の，通信サーバとは別のTP1/Server Baseで収納業務プログラムを稼働させる場合は，それぞれのOpenTP1のシステム共通定義（betranrc）の「all_node」を必ず指定してください。指定方法については，「4.2.4(3)　システム共通定義（betranrc）」を参照してください。

(11)　照会収納業務プログラムデフォルト定義

照会収納業務プログラムデフォルト定義の定義項目を次に示します。照会収納業務プログラムデフォルト定義は，[HMPN/BL/SRV/（収納機関コード）/REF]タグのセクションに記述します。タグ内の（収納機関コード）には，各収納機関の収納機関コードを指定してください。なお，定義内の項目は，必ず記述してください。

表4-36　照会収納業務プログラムデフォルト定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの照会SPPの，デフォルトのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの照会SPPの，デフォルトのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの照会SPPの，デフォルトのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの照会SPPの，デフォルトのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

また，地方税・地公体料金，または国庫金（収納機関コードが国税庁（00200000）の場合だけ）の場合，納付区分ごとに収納業務プログラムのSPPに電文を振り分けるときは，[HMPN/BL/SRV/（収納機関コード）/REF/（納付区分）]タグのセクションに記述してください。タグ内の（納付区分）には，次の内容を指定してください。

地方税・地公体料金の場合：「納付区分」の税目・料金番号（3桁）

国庫金の場合：「納付区分」（1～16桁）

表4-37　照会収納業務プログラム定義納付区分タグ

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの照会SPPのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの照会SPPのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの照会SPPのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの照会SPPのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

(12)　消込収納業務プログラムデフォルト定義

消込収納業務プログラムデフォルト定義の定義項目を次に示します。消込収納業務プログラムデフォルト定義は，[HMPN/BL/SRV/（収納機関コード）/PAY]タグのセクションに記述します。タグ内の（収納機関コード）には，各収納機関の収納機関コードを指定してください。なお，定義内の項目は，必ず記述してください。

表4-38　消込収納業務プログラムデフォルト定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの消込SPPの，デフォルトのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの消込SPPの，デフォルトのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの消込SPPの，デフォルトのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの消込SPPの，デフォルトのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

また，地方税・地公体料金，または国庫金（収納機関コードが国税庁（00200000）の場合だけ）の場合，納付区分ごとに収納業務プログラムのSPPに電文を振り分けるときは，[HMPN/BL/SRV/（収納機関コード）/PAY/（納付区分）]タグのセクションに記述してください。タグ内の（納付区分）には，次の内容を指定してください。

地方税・地公体料金の場合：「納付区分」の税目・料金番号（3桁）

国庫金の場合：「納付区分」（1～16桁）

表4-39　消込収納業務プログラム定義納付区分タグ

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの消込SPPのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの消込SPPのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの消込SPPのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの消込SPPのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

(13)　取消収納業務プログラムデフォルト定義

取消収納業務プログラムデフォルト定義の定義項目を次に示します。取消収納業務プログラムデフォルト定義は，[HMPN/BL/SRV/（収納機関コード）/CAN]タグのセクションに記述します。タグ内の（収納機関コード）には，各収納機関の収納機関コードを指定してください。なお，定義内の項目は，必ず記述してください。

表4-40　取消収納業務プログラムデフォルト定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの取消SPPの，デフォルトのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの取消SPPの，デフォルトのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの取消SPPの，デフォルトのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの取消SPPの，デフォルトのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

また，地方税・地公体料金，または国庫金（収納機関コードが国税庁（00200000）の場合だけ）の場合，納付区分ごとに収納業務プログラムのSPPに電文を振り分けるときは，[HMPN/BL/SRV/（収納機関コード）/CAN/（納付区分）]タグのセクションに記述してください。タグ内の（納付区分）には，次の内容を指定してください。

地方税・地公体料金の場合：「納付区分」の税目・料金番号（3桁）

国庫金の場合：「納付区分」（1～16桁）

表4-41　取消収納業務プログラム定義納付区分タグ

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの取消SPPのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの取消SPPのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの処理SPPのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの取消SPPのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

(14)　再送確認収納業務プログラムデフォルト定義

再送確認収納業務プログラムデフォルト定義の定義項目を次に示します。再送確認収納業務プログラムデフォルト定義は，[HMPN/BL/SRV/（収納機関コード）/RESEND]タグのセクションに記述します。（収納機関コード）には，各収納機関の収納機関コードを指定してください。なお，定義内の項目は，必ず記述してください。

表4-42　再送確認収納業務プログラムデフォルト定義

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの再送確認SPPの，デフォルトのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの再送確認SPPの，デフォルトのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの再送確認SPPの，デフォルトのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの再送確認SPPの，デフォルトのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

また，地方税・地公体料金，または国庫金（収納機関コードが国税庁（00200000）の場合だけ）の場合，納付区分ごとに収納業務プログラムのSPPに電文を振り分けるときは，[HMPN/BL/SRV/（収納機関コード）/RESEND/（納付区分）]タグのセクションに記述してください。タグ内の（納付区分）には，次の内容を指定してください。

地方税・地公体料金の場合：「納付区分」の税目・料金番号（3桁）

国庫金の場合：「納付区分」（1～16桁）

表4-43　再送確認収納業務プログラム定義納付区分タグ

定義名 | 定義内容 | 定義値の条件 | 推奨値 | 説明 | 定義が必要な構成の種類
SERVICEGRP | 収納業務プログラムの再送確認SPPのサービスグループ名 | <識別子>（1～31文字） | － | 収納業務プログラムの再送確認SPPのサービスグループ名を指定します。通信サーバfor Biller共通定義，および通信サーバfor Biller業務系SPP定義で指定したサービスグループ名と異なるサービスグループ名を指定してください。 | 共通
SERVICE | 収納業務プログラムの再送確認SPPのサービス名 | <識別子>（1～31文字） | － | 収納業務プログラムの再送確認SPPのサービス名を指定します。 | 共通

（凡例）

－：該当なし

共通：どの構成でも指定する項目

4.4.5　通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権

通信サーバシステム定義の通信サーバfor Biller共通定義（[HMPN/BL]）に指定するディレクトリおよびファイルには，適切なアクセス権を設定しておく必要があります。適切なアクセス権が設定されていないと，通信サーバfor Billerは処理を正常に実行できません。

そのため，通信サーバシステム定義を作成したあとには，指定したディレクトリおよびファイルのアクセス権を確認してください。各ディレクトリおよびファイルには，次に示す値以上のアクセス権が必要です。

なお，定義チェックコマンド（hmpndefchk）を実行すると，これらのアクセス権がチェックされます。定義チェックコマンドについては，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

表4-44　通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権

定義内容 | アクセス権 | 通信サーバシステム定義の定義名
共通ソフトウェアの環境設定ファイル（オンライン電文用） | 440 | MPN_BL_SOFT_ENV_FILE
共通ソフトウェア起動コマンド | 550 | MPN_BL_SOFT_MQ_STT_SH
共通ソフトウェア停止コマンド | 550 | MPN_BL_SOFT_MQ_STP_SH
状態管理ファイル用ロウ論理ボリューム名 | 660 | RAW_BL_STAT
業務系SPP状態ファイル用ロウ論理ボリューム名 | 660 | RAW_WORKPRC_STAT

4.5　HAモニタの定義

HAモニタの定義の概要，定義の手順，およびHAモニタの定義項目について説明します。

＜この節の構成＞

4.5.1　HAモニタの定義の概要

4.5.2　HAモニタの定義の手順

4.5.3　HAモニタの定義項目

4.5.4　LANの状態設定ファイルの作成

4.5.1　HAモニタの定義の概要

HAモニタの定義はHA環境を構築するための定義です。HAモニタの定義は，テキスト形式の定義ファイルに記述します。

通信サーバfor Billerのシステムで考えられる次のHA構成で，HAモニタの定義項目，およびその定義値は異なります。

通信サーバfor Biller単独でのHA構成（通信サーバfor Billerだけを切り替える構成）

通信サーバfor Biller単独でのHA構成（通信サーバBaseおよび通信サーバfor Billerを切り替える構成）

通信サーバBaseと通信サーバfor Biller双方でのHA構成

また，通信サーバBaseは，HAモニタとのインターフェースを持たないサーバであるため，系切り替えをする場合，HAモニタはモニタモードで監視します。

HAモニタの定義ファイルの一覧を次に示します。なお，障害時に系切り替えする場合に備え，HiRDBおよびOpenTP1でLANの状態設定ファイルを作成します。LANの状態設定ファイルの作成については「4.5.4　LANの状態設定ファイルの作成」を参照してください。

表4-45　HAモニタの定義ファイル一覧

ファイル名 | 定義の種類 | 説明 | サンプルファイルの有無
servers | サーバの環境設定 | OpenTP1，およびHiRDBのHA構成の環境を定義します。また，通信サーバBaseおよび通信サーバfor Billerを切り替える構成ではリソースサーバを定義することを推奨します。なお，通信サーバBaseと通信サーバfor Biller双方でのHA構成では，リソースサーバを必ず定義します。 | ×
sysdef | HAモニタの環境設定 | HAモニタの環境を定義します。 | ×

（凡例）

×：サンプルファイルがない

なお，ここで説明する定義項目以外の定義項目については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

4.5.2　HAモニタの定義の手順

HAモニタの定義は次の手順で行ってください。

定義ファイルを作成する
HAモニタの定義には，サンプルファイルがありません。定義ファイルについては，「4.5.3　HAモニタの定義項目」を参照してください。

定義ファイルを編集する
必要に応じて，定義ファイルを編集してください。

定義ファイルを所定のディレクトリに格納する

定義ファイルの編集方法，および定義ファイルの格納先については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

4.5.3　HAモニタの定義項目

HAモニタの定義をファイルごとに説明します。各項目の詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。また，各定義ファイルの記述例については，「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」または，「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」を参照してください。

＜この項の構成＞

(1)　サーバの環境設定（servers）

(2)　HAモニタの環境設定（sysdef）

(1)　サーバの環境設定（servers）

サーバ（HiRDB，OpenTP1および通信サーバBase）の環境設定をします。

サーバの環境設定では，次の2種類の定義文を使用します。

server定義文

resource定義文

設定するサーバおよび定義文は，HA構成の形態によって異なります。

(a)　通信サーバfor Biller単独でのHA構成の場合

●通信サーバfor Billerだけを切り替える構成

次の定義文を使用します。

server定義文

サンプルファイルはありません。ファイルを作成し，次に示す項目を必ず定義してください。これらは，現用系と予備系で同じ値を指定してください。表中にない項目については，環境に合わせて定義できます。

この定義文では，HiRDBとOpenTP1についての定義が必要です。ただし，HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合は，OpenTP1の定義だけを作成してください。

表4-46　server定義文（通信サーバfor Biller単独でのHA構成－通信サーバfor Billerだけを切り替える場合）

項目名
説明
定義値（HiRDB）
定義値（OpenTP1）
定義値の変更

name
HiRDB，OpenTP1のそれぞれのセットアップディレクトリを絶対パスで指定してください。
任意
任意
○

alias
HA定義の「HA_KIND」に「SRV」を指定した場合は，「SV_GRP」に指定した値を指定してください。それ以外の場合は，サーバプログラムの識別名（サーバの別名）を任意に指定できます。
任意
任意
○

acttype
サーバの起動方法を指定します。
server
server
×

switchtype
サーバ障害を検出した場合，系切り替えを行う指定をします。
switch
switch
×

group
HA定義の「HA_KIND」に「GRP」を指定した場合は，「SV_GRP」で指定した値を指定してください。切り替え種別には，「exchange」（連動系切り替え）を指定してください。※1
グループ名:exchange
（グループ名部分は任意）
グループ名:exchange
（グループ名部分は任意）
○※2

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。
use
use
×

disk
通信サーバのロウ論理ボリューム，および共通ソフトウェアのキューマネージャー用の論理ボリュームを含むボリュームグループ名を指定してください。
任意
任意
○

fs_name
共通ソフトウェアのキューマネージャー用論理ボリュームを絶対パスで指定してください。
－
任意
○

fs_mount_dir
共通ソフトウェアのキューマネージャー用論理ボリュームをマウントするディレクトリを絶対パスで指定してください。
－
任意
○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

×：必ず「定義値」欄の値を指定する

－：該当しない

注※1

HiRDB，OpenTP1で共通の値となります。

注※2

exchange部分は変更できません。

●通信サーバBaseおよび通信サーバfor Billerを切り替える構成

次の定義文を使用します。

server定義文

resource定義文※

注※

この構成の場合，リソースサーバの使用を推奨します。

サンプルファイルはありません。ファイルを作成し，各定義文で，次に示す項目を必ず定義してください。これらは，現用系と予備系で同じ値を指定してください。

server定義文

server定義文で必要な項目を次に示します。

この定義文では，HiRDB，OpenTP1についての定義が必要です。ただし，HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合は，OpenTP1の定義だけを作成してください。

表中にない項目については，環境に合わせて定義できます。

表4-47　server定義文（通信サーバfor Biller単独でのHA構成－通信サーバBaseおよび通信サーバfor Billerを切り替える場合）

項目名
説明
定義値（HiRDB）
定義値（OpenTP1）
定義値の変更

name
HiRDB，OpenTP1のそれぞれのセットアップディレクトリを絶対パスで指定してください。
任意
任意
○

alias
HA定義の「HA_KIND」に「SRV」を指定した場合は，「SV_GRP」に指定した値を指定してください。それ以外の場合は，サーバプログラムの識別名（サーバの別名）を任意に指定できます。
任意
任意
○

acttype
サーバの起動方法を指定します。
server
server
×

switchtype
サーバ障害を検出した場合，系切り替えを行う指定をします。
switch
switch
×

group
HA定義の「HA_KIND」に「GRP」を指定した場合は，「SV_GRP」で指定した値を指定してください。切り替え種別には，「exchange」（連動系切り替え）を指定してください。※1
グループ名:exchange
（グループ名部分は任意）
グループ名:exchange
（グループ名部分は任意）
○※2

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。
use
use
×

parent
自サーバを起動するために必要なリソースサーバの識別名（リソースサーバの別名）を指定してください。※1
任意
任意
○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

×：必ず「定義値」欄の値を指定する

注

ファイル転送機能，オンライン機能に関係する通信サーバおよび共通ソフトウェアのリソース制御は，リソースサーバで行います。そのため，disk，fs_nameおよびfs_mount_dirは，server定義文ではなくresource定義文で指定します。

ただし，ファイル転送機能，オンライン機能に関係ないHiRDBおよびOpenTP1のリソース制御は，自サーバ，リソースサーバのどちらでも行えるため，環境に合わせて指定してください。

注※1

HiRDB，OpenTP1で共通の値となります。

注※2

exchange部分は変更できません。

resource定義文

resource定義文で必要な項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-48　resource定義文（通信サーバfor Biller単独でのHA構成－通信サーバBaseおよび通信サーバfor Billerを切り替える場合）

項目名
説明
定義値
定義値の変更

alias
server定義文の「parent」で指定した識別名を指定してください。
任意
○

group
HA定義の「SV_GRP」で指定した値を指定してください。切り替え種別には「exchange」（連動系切り替え）を指定してください。
グループ名:exchange
（グループ名部分は任意）
○※1

disk
通信サーバのロウ論理ボリューム，および共通ソフトウェアのキューマネージャー用の論理ボリュームを含むボリュームグループ名を指定してください。※2
任意
○

fs_name
共通ソフトウェアのキューマネージャー用論理ボリューム，および通信サーバBaseの受信ファイル格納ディレクトリ用論理ボリュームを絶対パスで指定してください。※2
任意
○

fs_mount_dir
共通ソフトウェアのキューマネージャー用論理ボリュームをマウントするディレクトリ，および通信サーバBaseの受信ファイル格納ディレクトリ用論理ボリュームをマウントするディレクトリを絶対パスで指定してください。※2
任意
○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

注※1

exchange部分は変更できません。

注※2

server定義文での指定内容と重複がないか確認してください。

(b)　通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合

リソースサーバを使った連動系切り替えを行うため，次の定義文を使用します。

server定義文

resource定義文

サンプルファイルはありません。ファイルを作成し，各定義文で，次に示す項目を必ず定義してください。これらは，現用系と予備系で同じ値を指定してください。

server定義文

server定義文で必要な項目を次に示します。

この定義文では，HiRDB，OpenTP1，および通信サーバBaseついての定義が必要です。ただし，HiRDBと通信サーバfor Billerを別のマシンにセットアップする場合は，OpenTP1，および通信サーバBaseの定義だけを作成してください。

表中にない項目については，環境に合わせて定義できます。

表4-49　server定義文（通信サーバBaseと通信サーバfor Biller双方でのHA構成）

項目名
説明
定義値（HiRDB）
定義値（OpenTP1）
定義値（通信サーバBase）
※1
定義値の変更

name
HiRDB，OpenTP1ではそれぞれのセットアップディレクトリ，通信サーバBaseでは通信サーバ起動シェル※2の絶対パスを指定してください。
任意
任意
任意
○

alias
HA定義の「HA_KIND」に「SRV」を指定した場合は，「SV_GRP」に指定した値を指定してください。それ以外の場合は，サーバプログラムの識別名（サーバの別名）を任意に指定できます。
任意
任意
任意
○

acttype
サーバの起動方法を指定します。
server
server
monitor
×

termcommand
作成したサーバの終了コマンドを絶対パスで指定してください。
－
－
任意
○

switchtype
サーバ障害を検出した場合，系切り替えを行う指定をします。
switch
switch
－
×

group
HA定義の「SV_GRP」で指定した値を指定してください。切り替え種別には「exchange」（連動系切り替え）を指定してください。
※3
グループ名:exchange
（グループ名部分は任意）
グループ名:exchange
（グループ名部分は任意）
グループ名:exchange
（グループ名部分は任意）
○※4

lan_updown
LANの状態設定ファイルを使用するかどうかを指定します。
use
use
use
×

waitserv_exec
HAモニタの実行サーバ起動完了処理を実行する前に「name」で指定したサーバの実行完了を待つかどうかを指定します。
－
－
yes
×

parent
自サーバを起動するために必要なリソースサーバの識別名（リソースサーバの別名）を指定します。
※3
任意
任意
任意
○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

×：必ず「定義値」欄の値を指定する

－：該当しない

注

ファイル転送機能，オンライン機能に関係する通信サーバおよび共通ソフトウェアのリソース制御は，リソースサーバで行います。そのため，disk，fs_nameおよびfs_mount_dirは，server定義文ではなくresource定義文で指定します。

ただし，ファイル転送機能，オンライン機能に関係ないHiRDBおよびOpenTP1のリソース制御は，リソースサーバのどちらでも行えるため，環境に合わせて指定してください。

注※1

通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合，通信サーバシステム定義の[HMPN/FTHA]タグ下に「SRV_NAME」を指定しないでください。ただし，タグ名（[HMPN/FTHA]）は指定する必要があります。

注※2

オプションを指定する場合は，「actcommand」を定義してください。

注※3

HiRDB，OpenTP1，および通信サーバBaseで共通の値となります。

注※4

exchange部分は変更できません。

resource定義文

resource定義文で必要な項目を次に示します。表中にない項目については，環境に合わせて定義できます。

表4-50　resource定義文（通信サーバBaseと通信サーバfor Biller双方でのHA構成）

項目名
説明
定義値
定義値の変更

alias
server定義文の「parent」で指定した識別名を指定してください。
任意
○

group
HA定義の「SV_GRP」で指定した値を指定してください。切り替え種別には「exchange」（連動系切り替え）を指定してください。
グループ名:exchange
（グループ名部分は任意）
○※1

disk
通信サーバのロウ論理ボリューム，および共通ソフトウェアのキューマネージャー用の論理ボリュームを含むボリュームグループ名を指定してください。※2
任意
○

fs_name
共通ソフトウェアのキューマネージャー用論理ボリューム，および通信サーバBaseの受信ファイル格納ディレクトリ用論理ボリュームを絶対パスで指定してください。※2
任意
○

fs_mount_dir
共通ソフトウェアのキューマネージャー用論理ボリュームをマウントするディレクトリ，および通信サーバBaseの受信ファイル格納ディレクトリ用論理ボリュームをマウントするディレクトリを絶対パスで指定してください。※2
任意
○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

注※1

exchange部分は変更できません。

注※2

server定義文での指定内容と重複がないか確認してください。

(2)　HAモニタの環境設定（sysdef）

HAモニタの環境設定には，サンプルファイルがありません。ファイルを作成し，次に示す項目を必ず定義してください。表中にない項目については，環境に合わせて定義できます。

表4-51　HAモニタの環境設定

定義文の種類 | 項目名 | 説明 | 定義値 | 定義値の変更
function | usrcommand | 共通ソフトウェアを強制停止させるシェルを絶対パスで指定してください。 | 任意 | ○

（凡例）

○：「説明」欄の条件で，任意の値を指定する

4.5.4　LANの状態設定ファイルの作成

サーバの切り離しおよび接続を制御するためにHAモニタが使用するのがLANの状態設定ファイルです。HA構成の場合，系切り替えの設定として，OpenTP1用のLANの状態設定ファイルを必ず作成してください。また，HiRDB用のLANの状態設定ファイルについては，必要に応じて作成してください。なお，HiRDBと通信サーバfor Billerが別のマシンにセットアップされている場合，HiRDB用のLANの状態設定ファイルは不要です。

次に示すLANの状態設定ファイルをHAモニタの環境設定用ディレクトリの下に作成します。HAモニタの環境設定用ディレクトリは，HAモニタの定義ファイルの格納先と同じです。

表4-52　LANの状態設定ファイル

ファイルの形式 | 説明
（サーバ識別名）.up | LANを接続する場合に使用します。
（サーバ識別名）.down | LANを切り離す場合に使用します。

サンプルファイルの格納先，および各設定ファイルの記述方法については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

また，LANの状態設定ファイルの記述例については，「4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）」または，「4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）」を参照してください。

4.6　トレースの設定

通信サーバシステム定義の設定には，プロセス別トレースのトレースファイルサイズおよびトレースファイル数の見積もりが必要です。システム構築時にテストを実施するとき，またはトラブルシュート時に詳細な障害情報が必要になったときには，トレース出力レベルおよびしきい値の見直しが必要です。

ここでは，プロセス別トレースのトレースファイルサイズとトレースファイル数の見積もり方法，およびトレースの出力レベルとしきい値について説明します。通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

＜この節の構成＞

4.6.1　トレースファイルの見積もり

4.6.2　トレースの出力レベルとしきい値

4.6.1　トレースファイルの見積もり

プロセス別トレースのトレースファイルサイズおよびトレースファイル数の見積もり方法を説明します。トレースファイルサイズおよびトレースファイル数は，それぞれ通信サーバシステム定義（通信サーバfor Biller共通定義）のTRC_FILE_SIZEおよびTRC_FILE_NUMに指定します。

次に，トレースファイルサイズおよびトレースファイル数の見積もり方法を示します。

業務電文の件数，およびトレースを保管する日数を見積もる
次の項目の見積もりをしてください。

1日当たりに受信する業務電文（単位：件）

トレース情報を保存する期間（単位：日）

（例）

1日当たりに受信する業務電文＝10,000件

トレース情報を保存する期間＝3日

総ファイルサイズを算出する
手順1で見積もった値から，総ファイルサイズを算出してください。
総ファイルサイズは，次の式によって算出します。トレースにはエラーメッセージなども出力されるため，手順1で見積もった値に安全係数1.25を掛けてください。

総ファイルサイズ＝1行当たりに出力するトレース量（バイト）×1日当たりに受信する業務電文（件）×1業務電文のトレース取得回数（回）×トレース情報を保存する期間（日）×1.25

1行当たりに出力するトレース量は平均220バイトです。1業務電文のトレース取得回数は8回です。
220（バイト）×10,000（件）×8（回）×3（日間分）×1.25＝66,000,000（バイト）
この場合は，約66MBのファイルサイズが必要です。

トレースファイルサイズとトレースファイル数を決める
手順2で見積もった値から，トレースファイルサイズおよびトレースファイル数を見積もります。トレースファイルは複数個設定できます。トレースファイルサイズおよびトレースファイル数は，次の二つの方法で見積もることができます。

トレースファイルサイズから見積もる場合

トレースファイル数（ファイル）＝総ファイルサイズ（バイト）÷トレースファイルサイズ（バイト）

（例）一つのトレースファイルサイズを6,600,000バイトと仮定した場合

66,000,000（バイト）÷6,600,000（バイト）＝10（ファイル）※1

この場合，通信サーバシステム定義に指定する値は次のようになります。

TRC_FILE_NUM=10

TRC_FILE_SIZE=6,600,000※2

注※1

算出したトレースファイル数の値が整数でなかった場合は，小数点第一位を切り上げてください。

注※2

通信サーバシステム定義に指定する時には，桁区切りの「,」を入れないでください。

トレースファイル数から見積もる場合

トレースファイルサイズ（バイト）＝総ファイルサイズ（バイト）÷トレースファイル数（ファイル）

（例）トレースファイル数を6と仮定した場合

66,000,000（バイト）÷6（ファイル）＝11,000,000（バイト）※1

この場合，通信サーバシステム定義に指定する値は次のようになります。

TRC_FILE_NUM=6

TRC_FILE_SIZE=11,000,000※2

注※1

算出したトレースファイルサイズの値が整数でなかった場合は，小数点第一位を切り上げてください。

注※2

通信サーバシステム定義に指定する時には，桁区切りの「,」を入れないでください。

注意

システム構築時に，テストを実施する場合を除き，トレースファイル数には，2以上を指定してください。

4.6.2　トレースの出力レベルとしきい値

通信サーバシステム定義に指定する，トレース出力レベル，プロセス別トレースのしきい値および統合トレースのしきい値について説明します。定義値の変更が必要な場合は，参考にしてください。

トレースにはプロセスごとに取得するプロセス別トレースと，マシン上で動くプロセス全体のトレース情報を取得する統合トレースがあります。

トレースに出力されるメッセージのエラーレベルは，トレースレベルによって異なります。トレースレベルと出力されるメッセージのエラーレベルを次に示します。

表4-53　トレースレベルと出力されるメッセージ

トレース
レベル
基準
出力されるメッセージ
のエラーレベル

0
システムの稼働時に必ず出力されます。性能への影響は，無視できる程度です。
エラーメッセージ（-E）まで

10
システムの稼働時に必ず出力されます。性能への影響は，無視できる程度です。
警告メッセージ（-W）まで

20
ユーザーサイトで再現テスト時に出力されます。性能への影響があっても，処理の流れの概略がわかるレベルです。
注意メッセージ（-C）まで

30
障害調査用です。
付加情報メッセージ（-I）まで

プロセス別トレースと統合トレースに出力するメッセージは，次の項目で設定します。

トレース出力レベル
プロセス別トレースおよび統合トレースは，この値より小さい場合に出力されます。

プロセス別トレースのしきい値
プロセス別トレースは，この値より大きく，トレース出力レベルよりも小さい場合に出力されます。

統合トレースのしきい値
統合トレースは，この値またはトレース出力レベルのどちらかより小さい場合に出力されます。

トレースレベルとしきい値の関係を次に示します。

図4-9　トレースレベルとしきい値の関係

上記の図では，次のようなトレースレベルの推奨値を通信サーバシステム定義で指定しています。

トレース出力レベル（TRC_LEVEL）=10

プロセス別トレースのしきい値（TRC_PRC_LEVEL）=0

統合トレースのしきい値（TRC_SHM_LEVEL）=0

推奨値を指定した場合，プロセス別トレースにはトレースレベル0および10の内容が出力されます。また，統合トレースには，トレースレベル0の内容が出力されます。

注意

次のような場合を除き，トレース出力レベル，プロセス別トレースのしきい値，および統合トレースのしきい値には推奨値を指定してください。

システム構築時に，テストを実施するとき

トラブルシュート時に，詳細な障害情報が必要になったとき

4.7　定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）

ここでは，次の図を基に，HA構成を構築する場合の各定義ファイルの記述例を示します。また，構築するOSはHP-UXとします。ただし，HAモニタの定義のうち，各OSで記述方法が異なるLANの状態設定ファイルについては，AIX 5Lについても示します。

図4-10　通信サーバfor Billerのシステム構築例（通信サーバfor Biller単独でのHA構成の場合）

また，この記述例での前提条件を次に示します。

HiRDBと通信サーバfor Billerを同一マシン上にセットアップしている（HiRDBはHiRDB/Single Serverである）

HAモニタでは，現用系，および予備系でお互いを監視する

通信サーバBaseのファイル転送機能と通信サーバfor Billerのオンライン機能を両方使用する

通信サーバfor Billerのオンライン機能に障害があった場合だけ，通信サーバBaseのファイル転送機能は予備系に切り替わる

地公体収納サービスを使用する

表4-54　セットアップディレクトリのパス（通信サーバfor Biller単独でのHA構成の場合）

ソフトウェア名 | 記述例の値
共通ソフトウェア | /var/mpncm
通信サーバ | /home/HMPN
OpenTP1 | /home/OpenTP1
HiRDB | /home/HiRDB

表4-55　共通ソフトウェアに必要な設定項目（通信サーバfor Biller単独でのHA構成の場合）

設定項目 | 記述例の値
ネットワーク設定 | ホスト名 | host_HMPN
エイリアスIPアドレス | xxx.xxx.xxx.105
共有ディスクに確保されているボリュームグループ | /dev/vg01
キューマネージャー用論理ボリューム | /dev/vg01/MQHAlvl
キューマネージャーのチャネル | オンライン電文用 | TO.N0000000000:TO.N9999900000
TO.N0000000001:TO.N9999900000
ファイル転送用 | TO.F0000000000:TO.F9999900000
TO.F0000000001:TO.F9999900000

表4-56　HAモニタの監視対象プログラムに必要な設定項目（通信サーバfor Biller単独でのHA構成の場合）

設定項目 | 通信サーバBase | 通信サーバfor Biller（OpenTP1） | HiRDB
ネットワーク設定 | ホスト名 | － | host_TP1 | host_DB
エイリアスIPアドレス | － | xxx.xxx.xxx.103 | xxx.xxx.xxx.104
サーバプログラム名 | － | /home/OpenTP1 | /home/HiRDB
サーバ識別名 | － | mpnTP1 | mpnDB
サーバグループ名 | － | MPNSVR
使用しているリソースサーバ名 | － | mpnRES
共有ディスクに確保されているボリュームグループ | /dev/vg01
ボリュームグループに格納されているボリューム | /dev/vg01/rHMPNFTST | /dev/vg01/rlvbl01 | －
/dev/vg01/rHMPNFTFL | /dev/vg01/rlvbl02
/dev/vg01/lvlft01

（凡例）

－：該当なし

表4-57　共有ディスク上に作成するボリューム（通信サーバfor Biller単独でのHA構成の場合）

種類 | 記述例の値
共通ソフトウェア | キューマネージャー用論理ボリューム | /dev/vg01/MQHAlvl
通信サーバfor Biller | 状態管理ファイル用ロウ論理ボリューム | /dev/vg01/rlvbl01
業務系SPP状態ファイル用ロウ論理ボリューム | /dev/vg01/rlvbl02
通信サーバBase | 受信ファイル格納ディレクトリ用論理ボリューム | /dev/vg01/lvlft01
状態管理ファイル用ロウ論理ボリューム | /dev/vg01/rHMPNFTST
受信ファイルリスト用ロウ論理ボリューム | /dev/vg01/rHMPNFTFL

なお，この記述例では，納付区分ごとに照会収納業務プログラムのSPPへ電文を振り分けます。通信サーバシステム定義について，次のように指定しています。ここで示す以外の業務系SPPについては，納付区分ごとに電文を振り分けません。なお，収納機関コードは「99999000」，納付区分の税目・料金番号は「101」および「102」を前提に指定しています。

表4-58　通信サーバシステム定義の指定例（通信サーバfor Biller単独でのHA構成の場合）

設定項目 | 記述例
収納機関コード | 99999000
納付区分（税目・料金番号） | 101および102
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号101） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号101） | ref_srv101
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号102） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号102） | ref_srv102

＜この節の構成＞

4.7.1　OpenTP1の定義の記述例

4.7.2　HiRDBの定義の記述例

4.7.3　通信サーバシステム定義の記述例

4.7.4　HAモニタの定義の記述例

4.7.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

4.7.1　OpenTP1の定義の記述例

OpenTP1の定義の記述例を次に示します。OpenTP1の定義については，「4.2　OpenTP1の定義」を参照してください。なお，ユーザサービス定義ファイルは，通信サーバシステム定義で指定する各SPPのユーザサーバ名と同じです。この関連の詳細については，「4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連」を参照してください。

システム環境定義（env）

set mode_conf                   = MANUAL1
set user_command_online         = /home/HMPN/bin/hmpnblstart
set start_scheduling_timing     = AFTER
set system_init_watch_time      = 600

putenv  HMPNDIR /home/HMPN
putenv  SHLIB_PATH /usr/lib:¥
                  /opt/hitachi/common/lib:¥
                  /home/OpenTP1/lib:¥
                  /home/HiRDB/client/lib:¥
                  /home/HiRDB/lib:¥
                  /home/HMPN/usrlib:¥
                  /home/HMPN/lib
putenv  NLSPATH    /usr/lib/nls/msg/%L/%N:¥
                  /usr/lib/nls/%l/%t/%c/%N:¥
                  /home/HMPN/lib/msg/%L/%N
putenv  PATH       /usr/bin:¥
                  /usr/mqm/bin:¥
                  /home/OpenTP1/bin:¥
                  /home/HMPN/bin
putenv  LANG ja_JP.SJIS

システムサービス構成定義（sysconf）

set uap_conf = Y
set ha_conf = Y

プロセスサービス定義（prc）

prcsvpath /home/OpenTP1/aplib

ユーザサービスデフォルト定義（usrrc）

putenv  HMPNDIR /home/HMPN
putenv  PATH       /usr/bin:¥
                  /usr/mqm/bin:¥
                  /home/OpenTP1/bin:¥
                  /home/HMPN/bin
putenv  SHLIB_PATH /usr/lib:¥
                  /opt/hitachi/common/lib:¥
                  /home/OpenTP1/lib:¥
                  /home/HiRDB/client/lib:¥
                  /home/HiRDB/lib:¥
                  /home/HMPN/usrlib:¥
                  /home/HMPN/lib
putenv  NLSPATH    /usr/lib/nls/msg/%L/%N:¥
                  /usr/lib/nls/%l/%t/%c/%N:¥
                  /home/HMPN/lib/msg/%L/%N

照会SPP用ユーザサービス定義（HMpnRef）

set module                  = "HMpnRef"
set service_group           = "hmpn_ref_srvgrp"
set service                 = "hmpn_ref_srv=hmpn_ref_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

消込SPP用ユーザサービス定義（HMpnPay）

set module                  = "HMpnPay"
set service_group           = "hmpn_pay_srvgrp"
set service                 = "hmpn_pay_srv=hmpn_pay_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

取消SPP用ユーザサービス定義（HMpnCan）

set module                  = "HMpnCan"
set service_group           = "hmpn_can_srvgrp"
set service                 = "hmpn_can_srv=hmpn_can_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

再送確認SPP用ユーザサービス定義（HMpnRes）

set module                  = "HMpnRes"
set service_group           = "hmpn_res_srvgrp"
set service                 = "hmpn_res_srv=hmpn_res_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

set module                  = "HMpnCnt"
set service_group           = "hmpn_cnt_srvgrp"
set service                 = "hmpn_cnt_srv=hmpn_cnt_srv", ¥
                             "hmpn_cnt_run=hmpn_cnt_run"
set parallel_count          = 1
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納業務受付SPP用ユーザサービス定義（HMpnRdb）

set module                  = "HMpnRdb"
set service_group           = "hmpn_rdb_srvgrp"
set service                 = "hmpn_npayins_srv=hmpn_npayins_srv", ¥
                             "hmpn_npayupd_srv=hmpn_npayupd_srv", ¥
                             "hmpn_npayref_srv=hmpn_npayref_srv", ¥
                             "hmpn_npaycan_srv=hmpn_npaycan_srv", ¥
                             "hmpn_demins_srv=hmpn_demins_srv", ¥
                             "hmpn_demupd_srv=hmpn_demupd_srv", ¥
                             "hmpn_demref_srv=hmpn_demref_srv", ¥
                             "hmpn_demcan_srv=hmpn_demcan_srv", ¥
                             "hmpn_kpayref_srv=hmpn_kpayref_srv", ¥
                             "hmpn_cpayref_srv=hmpn_cpayref_srv", ¥
                             "hmpn_cntref_srv=hmpn_cntref_srv", ¥
                             "hmpn_msgref_srv=hmpn_msgref_srv"
set parallel_count          = 6
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

4.7.2　HiRDBの定義の記述例

HiRDBの定義の記述例を次に示します。HiRDBの定義については，「4.3　HiRDBの定義」を参照してください。

システム共通定義（pdsys）

set pd_ha = use
set pd_ha_ipaddr_inherit = Y
pdunit -x host_DB -u BLUT -d "/home/HiRDB"
set pd_mode_conf = MANUAL2

ユニット制御情報定義（pdutsys）

set pd_unit_id = "BLUT"
set pd_hostname = host_HA01
set pd_ha_acttype = server

4.7.3　通信サーバシステム定義の記述例

通信サーバシステム定義の記述例を次に示します。この記述例の場合，地公体収納サービスを提供しています。また，障害監視対象外ユーザサーバ定義では，SPPすべてを監視対象にしています。なお，この場合，収納業務プログラムはhost_01上で稼働しています。通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

[COMMON]
CENTER_CODE            = "GRPDST0001"
[HMPN/CODE]
OWN_NAME               = "sjis"
MPN_NAME               = "jis"
[HMPN/DB]
CONNECT_RETRY_TIMES    = 15
CONNECT_RETRY_INTERVAL = 1
[HMPN/HA]
HA_KIND                = "GRP"
SV_GRP                 = "MPNSVR"
[HMPN/BL]
TRC_FILE_SIZE          = 11000000
TRC_FILE_NUM           = 6
TRC_LEVEL              = 10
TRC_PRC_LEVEL          = 0
TRC_SHM_LEVEL          = 0
TARGET_HOST            = "host_TP1:28888"
COUNT_USERSV           = "HMpnCnt"
COUNT_SERVICEGRP       = "hmpn_cnt_srvgrp"
COUNT_SERVICE          = "hmpn_cnt_srv"
COUNT_WAIT_TIME        = 10
RDB_USERSV             = "HMpnRdb"
BL_AUTO_START          = "MANUAL"
AUTO_OPEN              = "MANUAL"
OPEN_RETRY_TIMES       = 1
OPEN_RETRY_INTERVAL    = 10
MPN_BL_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ol.env"
MPN_BL_SOFT_MQ_STT_SH  = "/home/SP/bin/hamqm_start_csb"
MPN_BL_SOFT_MQ_STP_SH  = "/home/SP/bin/hamqm_stop_csb"
RAW_BL_STAT            = "/dev/vg01/rlvbl01"
RAW_WORKPRC_STAT       = "/dev/vg01/rlvbl02"
CHANNEL_NAME="TO.N0000000000:TO.N9999900000,TO.N0000000001:TO.N9999900000"
BL_ENV                 = "PDHOST=host_DB,",
                        "PDNAMEPORT=20000,PDUSER='"mpnha"/"mpnha"'"
[HMPN/BL/CUP]
CUP_COUNT              = 12
[HMPN/BL/MON]
CTLCUP_WATCH_TIMER     = 30
CTLCUP_WATCH_COUNT     = 3
CTLCUP_TERM_WATCH_TIME = 10
BUSCUP_WATCH_TIMER     = 30
BUSCUP_WATCH_COUNT     = 3
BUSCUP_TERM_WATCH_TIME = 10
OPENTP1_WATCH_TIMER    = 30
OPENTP1_WATCH_COUNT    = 6
[HMPN/BL/SRV/99999000]
AUTO_START             = "AUTO"
REF_USERSV             = "HMpnRef"
REF_SERVICEGRP         = "hmpn_ref_srvgrp"
REF_SERVICE            = "hmpn_ref_srv"
PAY_USERSV             = "HMpnPay"
PAY_SERVICEGRP         = "hmpn_pay_srvgrp"
PAY_SERVICE            = "hmpn_pay_srv"
CAN_USERSV             = "HMpnCan"
CAN_SERVICEGRP         = "hmpn_can_srvgrp"
CAN_SERVICE            = "hmpn_can_srv"
RESEND_USERSV          = "HMpnRes"
RESEND_SERVICEGRP      = "hmpn_res_srvgrp"
RESEND_SERVICE         = "hmpn_res_srv"
[HMPN/BL/SRV/99999000/COM]
HOST_NAME              = "host_01"
NAME_PORT              = 28889
[HMPN/BL/SRV/99999000/COM]
HOST_NAME              = "host_TP1"
NAME_PORT              = 28877
[HMPN/BL/SRV/99999000/REF]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv"
[HMPN/BL/SRV/99999000/REF/101]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv101"
[HMPN/BL/SRV/99999000/REF/102]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv102"
[HMPN/BL/SRV/99999000/PAY]
SERVICEGRP             = "srvgrp"
SERVICE                = "pay_srv"
[HMPN/BL/SRV/99999000/CAN]
SERVICEGRP             = "srvgrp"
SERVICE                = "can_srv"
[HMPN/BL/SRV/99999000/RESEND]
SERVICEGRP             = "srvgrp"
SERVICE                = "resend_srv"
[HMPN/FT]
FILE_WATCH_TIME     = 10
C_FILE_DIR_NAME     = "/var/mpncm/rcvfile/"
MPN_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ft.env"
MPN_SOFT_MQ_STT_SH  = "/home/SP/bin/hamqm_start_ft"
MPN_SOFT_MQ_STP_SH  = "/home/SP/bin/hamqm_stop_ft"
MPN_SOFT_RCV_STT_SH = "/var/mpncm/ft/start.sh"
MPN_SOFT_RCV_STP_SH = "/var/mpncm/ft/end.sh"
TRC_FILE_SIZE       = 150000
TRC_FILE_NUM        = 7
TRC_LEVEL           = 10
TRC_PRC_LEVEL       = 0
TRC_SHM_LEVEL       = 0
RAW_NAME_STAT       = "/dev/vg01/rHMPNFTST"
RAW_NAME_FLIST      = "/dev/vg01/rHMPNFTFL"
CHANNEL_NAME="TO.F0000000000:TO.F9999900000,TO.F0000000001:TO.F9999900000"

4.7.4　HAモニタの定義の記述例

HAモニタの定義の記述例を次に示します。HAモニタの定義については，「4.5　HAモニタの定義」を参照してください。

サーバの環境設定（servers）
現用系

/* server定義文（通信サーバfor Biller（OpenTP1）の場合） */
server  name
            /home/OpenTP1
      ,alias
            mpnTP1
      ,acttype
            server
      ,patrol
            10
      ,initial
            online
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* server定義文（HiRDBの場合） */
server  name
            /home/HiRDB
      ,alias
            mpnDB
      ,acttype
            server
      ,patrol
            10
      ,initial
            online
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* resource定義文 */
resource  alias
            mpnRES
        ,group
            MPNSVR:exchange
        ,disk
            /dev/vg01
        ,fs_name
            /dev/vg01/MQHAlvl:/dev/vg01/lvft01
        ,fs_mount_dir
            /MQHA:/var/mpncm/rcvfile;

予備系

/* server定義文（通信サーバfor Biller（OpenTP1）の場合） */
server  name
            /home/OpenTP1
      ,alias
            mpnTP1
      ,acttype
            server
      ,patrol
            10
      ,initial
            standby
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* server定義文（HiRDBの場合） */
server  name
            /home/HiRDB
      ,alias
            mpnDB
      ,acttype
            server
      ,patrol
            10
      ,initial
            standby
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* resource定義文 */
resource  alias
            mpnRES
        ,group
            MPNSVR:exchange
        ,disk
            /dev/vg01
        ,fs_name
            /dev/vg01/MQHAlvl:/dev/vg01/lvft01
        ,fs_mount_dir
            /MQHA:/var/mpncm/rcvfile;

HAモニタの環境設定（sysdef）
現用系

environment name   host_HA01
           ,address
                  1
           ,patrol
                  30
           ,lan   path11
           ,lanport
                  HAmon;
function     cpudown
                 online,
            pathpatrol
                     5,
            connect_retry
                     5:200,
            usrcommand
                  /home/SP/bin/usrcmd_mpn;

予備系

environment name   host_HA02
           ,address
                  2
           ,patrol
                  30
           ,lan   path21
           ,lanport
                  HAmon;
function     cpudown
                 online,
            pathpatrol
                     5,
            connect_retry
                     5:200,
            usrcommand
                  /home/SP/bin/usrcmd_mpn;

LANの状態設定ファイル（AIX 5Lの場合）
mpnTP1.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.103 alias netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnTP1.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.103 delete

mpnDB.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.104 alias netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnDB.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.104 delete

LANの状態設定ファイル（HP-UXの場合）
mpnTP1.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig lan0:1 inet xxx.xxx.xxx.103 netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnTP1.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig lan0:1 inet 0.0.0.0 netmask 0

mpnDB.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig lan0:2 inet xxx.xxx.xxx.104 netmask 255.255.255.0 broadcast xx.xxx.xxx.255

mpnDB.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig lan0:2 inet 0.0.0.0 netmask 0

4.7.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

/etc/hostsファイルおよび/etc/servicesファイルは次のように設定します。/etc/hostsファイルおよび/etc/servicesファイルの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

/etc/hostsファイルの設定

HiRDBのエイリアスIPとホスト名

xxx.xxx.xxx.104 host_DB

OpenTP1のエイリアスIPとホスト名

xxx.xxx.xxx.103 host_TP1

/etc/servicesファイルの設定

HAモニタ監視パスのサービス名

HAmon          7778/udp

4.8　定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

ここでは，次の図を基に，HA構成を構築する場合の各定義ファイルの記述例を示します。また，構築するOSはHP-UXとします。ただし，HAモニタの定義のうち，各OSで記述方法が異なるLANの状態設定ファイルについては，AIX 5Lについても示します。

図4-11　通信サーバfor Billerのシステム構築例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

また，この記述例での前提条件を次に示します。

HiRDBと通信サーバfor Billerを同一マシン上にセットアップしている（HiRDBはHiRDB/Single Serverである）

HAモニタでは，現用系，および予備系でお互いを監視する

地公体収納サービスを使用する

表4-59　セットアップディレクトリのパス（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

ソフトウェア名 | 記述例の値
共通ソフトウェア | /var/mpncm
通信サーバ | /home/HMPN
OpenTP1 | /home/OpenTP1
HiRDB | /home/HiRDB

表4-60　共通ソフトウェアに必要な設定項目（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

設定項目 | 記述例の値
ネットワーク設定 | ホスト名 | host_HMPN
エイリアスIPアドレス | xxx.xxx.xxx.105
共有ディスクに確保されているボリュームグループ | /dev/vg02
キューマネージャー用論理ボリューム | /dev/vg02/MQHAlvl
キューマネージャーのチャネル | オンライン電文用 | TO.N0000000000:TO.N9999900000
TO.N0000000001:TO.N9999900000
ファイル転送用 | TO.F0000000000:TO.F9999900000
TO.F0000000001:TO.F9999900000

表4-61　HAモニタの監視対象プログラムに必要な設定項目（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

設定項目 | 通信サーバBase | 通信サーバfor Biller（OpenTP1） | HiRDB
ネットワーク設定 | ホスト名 | host_HMPNFT | host_TP1 | host_DB
エイリアスIPアドレス | xxx.xxx.xxx.105 | xxx.xxx.xxx.103 | xxx.xxx.xxx.104
サーバプログラム名 | /home/start_FT | /home/OpenTP1 | /home/HiRDB
サーバ識別名 | mpnBASE | mpnTP1 | mpnDB
サーバグループ名 | MPNSVR
使用しているリソースサーバ名 | mpnRES
共有ディスクに確保されているボリュームグループ | /dev/vg02
ボリュームグループに格納されているボリューム | /dev/vg02/rHMPNFTST | /dev/vg02/rlvbl01 | －
/dev/vg02/rHMPNFTFL | /dev/vg02/rlvbl02
/dev/vg02/lvlft01

（凡例）

－：該当なし

表4-62　共有ディスク上に作成するボリューム（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

種類 | 記述例の値
共通ソフトウェア | キューマネージャー用論理ボリューム | /dev/vg02/MQHAlvl
通信サーバfor Biller | 状態管理ファイル用ロウ論理ボリューム | /dev/vg02/rlvbl01
業務系SPP状態ファイル用ロウ論理ボリューム | /dev/vg02/rlvbl02
通信サーバBase | 受信ファイル格納ディレクトリ用論理ボリューム | /dev/vg02/lvlft01
状態管理ファイル用ロウ論理ボリューム | /dev/vg02/rHMPNFTST
受信ファイルリスト用ロウ論理ボリューム | /dev/vg02/rHMPNFTFL

なお，この記述例では，納付区分ごとに照会収納業務プログラムの照会SPPへ電文を振り分けます。通信サーバシステム定義について，次のように指定しています。ここで示す以外の業務系SPPについては，納付区分ごとに電文を振り分けません。なお，収納機関コードは「99999000」，納付区分の税目・料金番号は「101」および「102」を前提に指定しています。

表4-63　通信サーバシステム定義の指定例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

設定項目 | 記述例
収納機関コード | 99999000
納付区分（税目・料金番号） | 101および102
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号101） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号101） | ref_srv101
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号102） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号102） | ref_srv102

＜この節の構成＞

4.8.1　OpenTP1の定義の記述例

4.8.2　HiRDBの定義の記述例

4.8.3　通信サーバシステム定義の記述例

4.8.4　HAモニタの定義の記述例

4.8.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

4.8.1　OpenTP1の定義の記述例

OpenTP1の定義の記述例を次に示します。OpenTP1の定義については，「4.2　OpenTP1の定義」を参照してください。なお，ユーザサービス定義ファイルは，通信サーバシステム定義で指定する各SPPのユーザサーバ名と同じです。この関連の詳細については，「4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連」を参照してください。

システム環境定義（env）

set mode_conf                   = MANUAL1
set user_command_online         = /home/HMPN/bin/hmpnblstart
set start_scheduling_timing     = AFTER
set system_init_watch_time      = 600

putenv  HMPNDIR /home/HMPN
putenv  SHLIB_PATH /usr/lib:¥
                  /opt/hitachi/common/lib:¥
                  /home/OpenTP1/lib:¥
                  /home/HiRDB/client/lib:¥
                  /home/HiRDB/lib:¥
                  /home/HMPN/usrlib:¥
                  /home/HMPN/lib
putenv  NLSPATH    /usr/lib/nls/msg/%L/%N:¥
                  /usr/lib/nls/%l/%t/%c/%N:¥
                  /home/HMPN/lib/msg/%L/%N
putenv  PATH       /usr/bin:¥
                  /usr/mqm/bin:¥
                  /home/OpenTP1/bin:¥
                  /home/HMPN/bin
putenv  LANG ja_JP.SJIS

システムサービス構成定義（sysconf）

set uap_conf = Y
set ha_conf  = Y

プロセスサービス定義（prc）

prcsvpath /home/OpenTP1/aplib

ユーザサービスデフォルト定義（usrrc）

putenv  HMPNDIR /home/HMPN
putenv  PATH       /usr/bin:¥
                  /usr/mqm/bin:¥
                  /home/OpenTP1/bin:¥
                  /home/HMPN/bin
putenv  SHLIB_PATH /usr/lib:¥
                  /opt/hitachi/common/lib:¥
                  /home/OpenTP1/lib:¥
                  /home/HiRDB/client/lib:¥
                  /home/HiRDB/lib:¥
                  /home/HMPN/usrlib:¥
                  /home/HMPN/lib
putenv  NLSPATH    /usr/lib/nls/msg/%L/%N:¥
                  /usr/lib/nls/%l/%t/%c/%N:¥
                  /home/HMPN/lib/msg/%L/%N

照会SPP用ユーザサービス定義（HMpnRef）

set module                  = "HMpnRef"
set service_group           = "hmpn_ref_srvgrp"
set service                 = "hmpn_ref_srv=hmpn_ref_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

消込SPP用ユーザサービス定義（HMpnPay）

set module                  = "HMpnPay"
set service_group           = "hmpn_pay_srvgrp"
set service                 = "hmpn_pay_srv=hmpn_pay_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

取消SPP用ユーザサービス定義（HMpnCan）

set module                  = "HMpnCan"
set service_group           = "hmpn_can_srvgrp"
set service                 = "hmpn_can_srv=hmpn_can_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

再送確認SPP用ユーザサービス定義（HMpnRes）

set module                  = "HMpnRes"
set service_group           = "hmpn_res_srvgrp"
set service                 = "hmpn_res_srv=hmpn_res_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

set module                  = "HMpnCnt"
set service_group           = "hmpn_cnt_srvgrp"
set service                 = "hmpn_cnt_srv=hmpn_cnt_srv", ¥
                             "hmpn_cnt_run=hmpn_cnt_run"
set parallel_count          = 1
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納業務受付SPP用ユーザサービス定義（HMpnRdb）

set module                  = "HMpnRdb"
set service_group           = "hmpn_rdb_srvgrp"
set service                 = "hmpn_npayins_srv=hmpn_npayins_srv", ¥
                             "hmpn_npayupd_srv=hmpn_npayupd_srv", ¥
                             "hmpn_npayref_srv=hmpn_npayref_srv", ¥
                             "hmpn_npaycan_srv=hmpn_npaycan_srv", ¥
                             "hmpn_demins_srv=hmpn_demins_srv", ¥
                             "hmpn_demupd_srv=hmpn_demupd_srv", ¥
                             "hmpn_demref_srv=hmpn_demref_srv", ¥
                             "hmpn_demcan_srv=hmpn_demcan_srv", ¥
                             "hmpn_kpayref_srv=hmpn_kpayref_srv", ¥
                             "hmpn_cpayref_srv=hmpn_cpayref_srv", ¥
                             "hmpn_cntref_srv=hmpn_cntref_srv", ¥
                             "hmpn_msgref_srv=hmpn_msgref_srv"
set parallel_count          = 6
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

4.8.2　HiRDBの定義の記述例

HiRDBの定義の記述例を次に示します。HiRDBの定義については，「4.3　HiRDBの定義」を参照してください。

システム共通定義（pdsys）

set pd_ha = use
set pd_ha_ipaddr_inherit = Y
pdunit -x host_DB -u BLUT -d "/home/HiRDB"
set pd_mode_conf = MANUAL2

ユニット制御情報定義（pdutsys）

set pd_unit_id = "BLUT"
set pd_hostname = host_HA01
set pd_ha_acttype = server

4.8.3　通信サーバシステム定義の記述例

通信サーバシステム定義の記述例を次に示します。この記述例の場合，地公体収納サービスを提供しています。また，障害監視対象外ユーザサーバ定義では，SPPすべてを監視対象にしています。なお，この場合，収納業務プログラムはhost_01上で稼働しています。通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

[COMMON]
CENTER_CODE            = "GRPDST0001"
[HMPN/CODE]
OWN_NAME               = "sjis"
MPN_NAME               = "jis"
[HMPN/DB]
CONNECT_RETRY_TIMES    = 15
CONNECT_RETRY_INTERVAL = 1
[HMPN/HA]
HA_KIND                = "GRP"
SV_GRP                 = "MPNSVR"
[HMPN/BL]
TRC_FILE_SIZE          = 11000000
TRC_FILE_NUM           = 6
TRC_LEVEL              = 10
TRC_PRC_LEVEL          = 0
TRC_SHM_LEVEL          = 0
TARGET_HOST            = "host_TP1:28888"
COUNT_USERSV           = "HMpnCnt"
COUNT_SERVICEGRP       = "hmpn_cnt_srvgrp"
COUNT_SERVICE          = "hmpn_cnt_srv"
COUNT_WAIT_TIME        = 10
RDB_USERSV             = "HMpnRdb"
BL_AUTO_START          = "MANUAL"
AUTO_OPEN              = "MANUAL"
OPEN_RETRY_TIMES       = 1
OPEN_RETRY_INTERVAL    = 10
MPN_BL_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ol.env"
MPN_BL_SOFT_MQ_STT_SH  = "/home/SP/bin/hamqm_start_csb"
MPN_BL_SOFT_MQ_STP_SH  = "/home/SP/bin/hamqm_stop_csb"
RAW_BL_STAT            = "/dev/vg02/rlvbl01"
RAW_WORKPRC_STAT       = "/dev/vg02/rlvbl02"
CHANNEL_NAME="TO.N0000000000:TO.N9999900000,TO.N0000000001:TO.N9999900000"
BL_ENV                 = "PDHOST=host_DB,",
                        "PDNAMEPORT=20000,PDUSER='"mpnha"/"mpnha"'"
[HMPN/BL/CUP]
CUP_COUNT              = 12
[HMPN/BL/MON]
CTLCUP_WATCH_TIMER     = 30
CTLCUP_WATCH_COUNT     = 3
CTLCUP_TERM_WATCH_TIME = 10
BUSCUP_WATCH_TIMER     = 30
BUSCUP_WATCH_COUNT     = 3
BUSCUP_TERM_WATCH_TIME = 10
OPENTP1_WATCH_TIMER    = 30
OPENTP1_WATCH_COUNT    = 6
[HMPN/BL/SRV/99999000]
AUTO_START             = "AUTO"
REF_USERSV             = "HMpnRef"
REF_SERVICEGRP         = "hmpn_ref_srvgrp"
REF_SERVICE            = "hmpn_ref_srv"
PAY_USERSV             = "HMpnPay"
PAY_SERVICEGRP         = "hmpn_pay_srvgrp"
PAY_SERVICE            = "hmpn_pay_srv"
CAN_USERSV             = "HMpnCan"
CAN_SERVICEGRP         = "hmpn_can_srvgrp"
CAN_SERVICE            = "hmpn_can_srv"
RESEND_USERSV          = "HMpnRes"
RESEND_SERVICEGRP      = "hmpn_res_srvgrp"
RESEND_SERVICE         = "hmpn_res_srv"
[HMPN/BL/SRV/99999000/COM]
HOST_NAME              = "host_01"
NAME_PORT              = 28889
[HMPN/BL/SRV/99999000/REF]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv"
[HMPN/BL/SRV/99999000/REF/101]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv101"
[HMPN/BL/SRV/99999000/REF/102]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv102"
[HMPN/BL/SRV/99999000/PAY]
SERVICEGRP             = "srvgrp"
SERVICE                = "pay_srv"
[HMPN/BL/SRV/99999000/CAN]
SERVICEGRP             = "srvgrp"
SERVICE                = "can_srv"
[HMPN/BL/SRV/99999000/RESEND]
SERVICEGRP             = "srvgrp"
SERVICE                = "resend_srv"
[HMPN/FT]
FILE_WATCH_TIME     = 10
C_FILE_DIR_NAME     = "/var/mpncm/rcvfile/"
MPN_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ft.env"
MPN_SOFT_MQ_STT_SH  = "/home/SP/bin/hamqm_start_ft"
MPN_SOFT_MQ_STP_SH  = "/home/SP/bin/hamqm_stop_ft"
MPN_SOFT_RCV_STT_SH = "/var/mpncm/ft/start.sh"
MPN_SOFT_RCV_STP_SH = "/var/mpncm/ft/end.sh"
TRC_FILE_SIZE       = 150000
TRC_FILE_NUM        = 7
TRC_LEVEL           = 10
TRC_PRC_LEVEL       = 0
TRC_SHM_LEVEL       = 0
RAW_NAME_STAT       = "/dev/vg02/rHMPNFTST"
RAW_NAME_FLIST      = "/dev/vg02/rHMPNFTFL"
CHANNEL_NAME="TO.F0000000000:TO.F9999900000,TO.F0000000001:TO.F9999900000"
[HMPN/FTHA]

4.8.4　HAモニタの定義の記述例

HAモニタの定義の記述例を次に示します。HAモニタの定義については，「4.5　HAモニタの定義」を参照してください。

サーバの環境設定（servers）
現用系

/* server定義文（通信サーバBaseの場合） */
server  name
            /home/start_FT
      ,alias
            mpnBASE
      ,acttype
            monitor
      ,termcommand
            /home/stop_FT
      ,initial
            online
      ,group
            MPNSVR:exchange
      ,lan_updown
            use
      ,waitserv_exec
            yes
      ,parent
            mpnRES;

/* server定義文（通信サーバfor Biller（OpenTP1）の場合） */
server  name
            /home/OpenTP1
      ,alias
            mpnTP1
      ,acttype
            server
      ,patrol
            10
      ,initial
            online
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* server定義文（HiRDBの場合） */
server  name
            /home/HiRDB
      ,alias
            mpnDB
      ,acttype
            server
      ,patrol
            10
      ,initial
            online
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* resource定義文 */
resource  alias
            mpnRES
        ,group
            MPNSVR:exchange
        ,disk
            /dev/vg02
        ,fs_name
            /dev/vg02/MQHAlvl:/dev/vg02/lvft01
        ,fs_mount_dir
            /MQHA:/var/mpncm/rcvfile;

予備系

/* server定義文（通信サーバBaseの場合） */
server  name
            /home/start_FT
      ,alias
            mpnBASE
      ,acttype
            monitor
      ,termcommand
            /home/stop_FT
      ,initial
            standby
      ,group
            MPNSVR:exchange
      ,lan_updown
            use
      ,waitserv_exec
            yes
      ,parent
            mpnRES;

/* server定義文（通信サーバfor Biller（OpenTP1）の場合） */
server  name
            /home/OpenTP1
      ,alias
            mpnTP1
      ,acttype
            server
      ,patrol
            10
      ,initial
            standby
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* server定義文（HiRDBの場合） */
server  name
            /home/HiRDB
      ,alias
            mpnDB
      ,acttype
            server
      ,patrol
            10
      ,initial
            standby
      ,pairdown
            nouse
      ,group
            MPNSVR:exchange
      ,switchtype
            switch
      ,lan_updown
            use
      ,parent
            mpnRES;

/* resource定義文 */
resource  alias
            mpnRES
        ,group
            MPNSVR:exchange
        ,disk
            /dev/vg02
        ,fs_name
            /dev/vg02/MQHAlvl:/dev/vg02/lvft01
        ,fs_mount_dir
            /MQHA:/var/mpncm/rcvfile;

HAモニタの環境設定（sysdef）
現用系

environment name   host_HA01
           ,address
                  1
           ,patrol
                  30
           ,lan   path11
           ,lanport
                  HAmon;
function     cpudown
                 online,
            pathpatrol
                     5,
            connect_retry
                     5:200,
            usrcommand
                  /home/SP/bin/usrcmd_mpn;

予備系

environment name   host_HA02
           ,address
                  2
           ,patrol
                  30
           ,lan   path21
           ,lanport
                  HAmon;
function     cpudown
                 online,
            pathpatrol
                     5,
            connect_retry
                     5:200,
            usrcommand
                  /home/SP/bin/usrcmd_mpn;

LANの状態設定ファイル（AIX 5Lの場合）
mpnBASE.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.105 alias netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnBASE.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.105 delete

mpnTP1.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.103 alias netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnTP1.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.103 delete

mpnDB.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.104 alias netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnDB.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig en0 inet xxx.xxx.xxx.104 delete

LANの状態設定ファイル（HP-UXの場合）
mpnBASE.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig lan0:1 inet xxx.xxx.xxx.105 netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnBASE.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig lan0:1 inet 0.0.0.0 netmask 0

mpnTP1.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig lan0:1 inet xxx.xxx.xxx.103 netmask 255.255.255.0 broadcast xxx.xxx.xxx.255

mpnTP1.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig lan0:1 inet 0.0.0.0 netmask 0

mpnDB.up

#!/bin/sh
#  Network Configuration for ONLINE
#
set -x
/etc/ifconfig lan0:2 inet xxx.xxx.xxx.104 netmask 255.255.255.0 broadcast xx.xxx.xxx.255

mpnDB.down

#!/bin/sh
# Network Configuration for OFFLINE
#
set -x
/etc/ifconfig lan0:2 inet 0.0.0.0 netmask 0

4.8.5　/etc/hostsファイルおよび/etc/servicesファイルの記述例

/etc/hostsファイルおよび/etc/servicesファイルは次のように設定します。/etc/hostsファイルおよび/etc/servicesファイルの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

/etc/hostsファイルの設定

HiRDBのエイリアスIPとホスト名

xxx.xxx.xxx.104 host_DB

OpenTP1のエイリアスIPとホスト名

xxx.xxx.xxx.103 host_TP1

通信サーバBaseのエイリアスIPとホスト名

xxx.xxx.xxx.105 host_HMPNFT

/etc/servicesファイルの設定

HAモニタ監視パスのサービス名

HAmon          7778/udp

4.9　定義ファイルの記述例（クラスタ構成の場合）

ここでは，次の図を基に，クラスタ構成を構築する場合の各定義ファイルの記述例を示します。また，構築するOSはHP-UXとします。

図4-12　通信サーバfor Billerのシステム構築例（クラスタ構成の場合）

また，この記述例での前提条件を次に示します。

サーバ二つで構成している

HiRDBと通信サーバfor Billerを同一マシン上にセットアップしている（HiRDBはHiRDB/Single Serverである）

地公体収納サービスを使用する

表4-64　セットアップディレクトリのパス（クラスタ構成の場合）

ソフトウェア名 | 記述例の値
共通ソフトウェア | /var/mpncm
通信サーバ | /home/HMPN
OpenTP1 | /home/OpenTP1
HiRDB | /home/HiRDB

表4-65　共通ソフトウェアに必要な設定項目（クラスタ構成の場合）

設定項目 | 記述例の値
通信サーバA | 通信サーバB
キューマネージャー（オンライン電文用）のチャネル | TO.N0000000000:TO.N9999900000 | TO.N0000000000:TO.N9999900001
TO.N0000000001:TO.N9999900000 | TO.N0000000001:TO.N9999900001

なお，この記述例では，納付区分ごとに照会収納業務プログラムの照会SPPへ電文を振り分けます。通信サーバシステム定義について，次のように指定しています。ここで示す以外の業務系SPPについては，納付区分ごとに電文を振り分けません。なお，収納機関コードは「99999000」，納付区分の税目・料金番号は「101」および「102」を前提に指定しています。

表4-66　通信サーバシステム定義の指定例（クラスタ構成の場合）

設定項目 | 記述例
収納機関コード | 99999000
納付区分（税目・料金番号） | 101および102
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号101） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号101） | ref_srv101
収納業務プログラムの照会SPPのサービスグループ名（税目・料金番号102） | srvgrp
収納業務プログラムの照会SPPのサービス名（税目・料金番号102） | ref_srv102

＜この節の構成＞

4.9.1　OpenTP1の定義の記述例

4.9.2　通信サーバシステム定義の記述例

4.9.1　OpenTP1の定義の記述例

OpenTP1の定義の記述例を次に示します。OpenTP1の定義については，「4.2　OpenTP1の定義」を参照してください。なお，ユーザサービス定義ファイルは，通信サーバシステム定義で指定する各SPPのユーザサーバ名と同じです。この関連の詳細については，「4.2.3　通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連」を参照してください。

また，この定義では，通信サーバAと通信サーバBで異なる値を指定する定義と，通信サーバAと通信サーバBで同じ値を指定する定義があります。

＜この項の構成＞

(1)　通信サーバAの記述例（異なる値を指定する定義）

(2)　通信サーバBの記述例（異なる値を指定する定義）

(3)　通信サーバAおよび通信サーバBの記述例（同じ値を指定する定義）

(1)　通信サーバAの記述例（異なる値を指定する定義）

システム環境定義（env）

set mode_conf                   = MANUAL1
set user_command_online         = "/home/HMPN/bin/hmpnblstart"
set start_scheduling_timing     = AFTER
set system_init_watch_time      = 600

putenv HMPNDIR  /home/HMPN
putenv PATH ¥
        /usr/bin:¥
        /usr/mqm/bin:¥
        /home/OpenTP1/bin:¥
        /home/HMPN/bin
putenv SHLIB_PATH ¥
        /usr/lib:¥
        /opt/hitachi/common/lib:¥
        /home/OpenTP1/lib:¥
        /home/HiRDB/client/lib:¥
        /home/HiRDB/lib:¥
        /home/HMPN/usrlib:¥
        /home/HMPN/lib
putenv NLSPATH ¥
        /usr/lib/nls/msg/%L/%N:¥
        /usr/lib/nls/%l/%t/%c/%N:¥
        /home/HMPN/lib/msg/%L/%N
putenv LANG ja_JP.SJIS
putenv  DCHOST host_CL_02:28888

システム共通定義（betranrc）

set all_node                    = "host_CL_02:28888"

ユーザサービスデフォルト定義（usrrc）

putenv HMPNDIR  /home/HMPN
putenv PATH ¥
        /usr/bin:¥
        /usr/mqm/bin:¥
        /home/OpenTP1/bin:¥
        /home/HMPN/bin
putenv SHLIB_PATH ¥
        /usr/lib:¥
        /opt/hitachi/common/lib:¥
        /home/OpenTP1/lib:¥
        /home/HiRDB/client/lib:¥
        /home/HiRDB/lib:¥
        /home/HMPN/usrlib:¥
        /home/HMPN/lib
putenv NLSPATH ¥
        /usr/lib/nls/msg/%L/%N:¥
        /usr/lib/nls/%l/%t/%c/%N:¥
        /home/HMPN/lib/msg/%L/%N

(2)　通信サーバBの記述例（異なる値を指定する定義）

システム環境定義（env）

set mode_conf                     = MANUAL1
set user_command_online           = "/home/HMPN/bin/hmpnblstart"
set start_scheduling_timing       = AFTER
set system_init_watch_time        = 600

putenv HMPNDIR  /home/HMPN
putenv PATH ¥
        /usr/bin:¥
        /usr/mqm/bin:¥
        /home/OpenTP1/bin:¥
        /home/HMPN/bin
putenv SHLIB_PATH ¥
        /usr/lib:¥
        /opt/hitachi/common/lib:¥
        /home/OpenTP1/lib:¥
        /home/HiRDB/client/lib:¥
        /home/HiRDB/lib:¥
        /home/HMPN/usrlib:¥
        /home/HMPN/lib
putenv NLSPATH ¥
        /usr/lib/nls/msg/%L/%N:¥
        /usr/lib/nls/%l/%t/%c/%N:¥
        /home/HMPN/lib/msg/%L/%N
putenv LANG ja_JP.SJIS
putenv  DCHOST host_CL_01:28887

システム共通定義（betranrc）

set all_node                    = "host_CL_01:28887"

ユーザサービスデフォルト定義（usrrc）

putenv HMPNDIR  /home/HMPN
putenv PATH ¥
        /usr/bin:¥
        /usr/mqm/bin:¥
        /home/OpenTP1/bin:¥
        /home/HMPN/bin
putenv SHLIB_PATH ¥
        /usr/lib:¥
        /opt/hitachi/common/lib:¥
        /home/OpenTP1/lib:¥
        /home/HiRDB/client/lib:¥
        /home/HiRDB/lib:¥
        /home/HMPN/usrlib:¥
        /home/HMPN/lib
putenv NLSPATH ¥
        /usr/lib/nls/msg/%L/%N:¥
        /usr/lib/nls/%l/%t/%c/%N:¥
        /home/HMPN/lib/msg/%L/%N

(3)　通信サーバAおよび通信サーバBの記述例（同じ値を指定する定義）

システムサービス構成定義（sysconf）

set uap_conf  =  Y

プロセスサービス定義（prc）

prcsvpath /home/OpenTP1/aplib

照会SPP用ユーザサービス定義（HMpnRef）

set module                  = "HMpnRef"
set service_group           = "hmpn_ref_srvgrp"
set service                 = "hmpn_ref_srv=hmpn_ref_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

消込SPP用ユーザサービス定義（HMpnPay）

set module                  = "HMpnPay"
set service_group           = "hmpn_pay_srvgrp"
set service                 = "hmpn_pay_srv=hmpn_pay_srv"
set parallel_count          = 4
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

取消SPP用ユーザサービス定義（HMpnCan）

set module                  = "HMpnCan"
set service_group           = "hmpn_can_srvgrp"
set service                 = "hmpn_can_srv=hmpn_can_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

再送確認SPP用ユーザサービス定義（HMpnRes）

set module                  = "HMpnRes"
set service_group           = "hmpn_res_srvgrp"
set service                 = "hmpn_res_srv=hmpn_res_srv"
set parallel_count          = 2
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

set module                  = "HMpnCnt"
set service_group           = "hmpn_cnt_srvgrp"
set service                 = "hmpn_cnt_srv=hmpn_cnt_srv", ¥
                             "hmpn_cnt_run=hmpn_cnt_run"
set parallel_count          = 1
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

収納業務受付SPP用ユーザサービス定義（HMpnRdb）

set module                  = "HMpnRdb"
set service_group           = "hmpn_rdb_srvgrp"
set service                 = "hmpn_npayins_srv=hmpn_npayins_srv", ¥
                             "hmpn_npayupd_srv=hmpn_npayupd_srv", ¥
                             "hmpn_npayref_srv=hmpn_npayref_srv", ¥
                             "hmpn_npaycan_srv=hmpn_npaycan_srv", ¥
                             "hmpn_demins_srv=hmpn_demins_srv", ¥
                             "hmpn_demupd_srv=hmpn_demupd_srv", ¥
                             "hmpn_demref_srv=hmpn_demref_srv", ¥
                             "hmpn_demcan_srv=hmpn_demcan_srv", ¥
                             "hmpn_kpayref_srv=hmpn_kpayref_srv", ¥
                             "hmpn_cpayref_srv=hmpn_cpayref_srv", ¥
                             "hmpn_cntref_srv=hmpn_cntref_srv", ¥
                             "hmpn_msgref_srv=hmpn_msgref_srv"
set parallel_count          = 6
set type                    = other
set hold                    = N
set service_hold            = N
set term_watch_time         = 30
set hold_recovery           = N
set receive_from            = queue
set atomic_update           = N
set node_down_restart       = N
set server_type             = "betran"
set cancel_normal_terminate = N
set critical                = N

4.9.2　通信サーバシステム定義の記述例

通信サーバシステム定義の記述例を次に示します。この記述例の場合，地公体収納サービスを提供しています。また，障害監視対象外ユーザサーバ定義では，SPPすべてを監視対象にしています。通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

＜この項の構成＞

(1)　通信サーバAの記述例

(2)　通信サーバBの記述例

(1)　通信サーバAの記述例

[COMMON]
CENTER_CODE            = "GRPDST0000"
[HMPN/CODE]
OWN_NAME               = "sjis"
MPN_NAME               = "jis"
[HMPN/DB]
CONNECT_RETRY_TIMES    = 15
CONNECT_RETRY_INTERVAL = 1
[HMPN/BL]
TRC_FILE_SIZE          = 11000000
TRC_FILE_NUM           = 6
TRC_LEVEL              = 10
TRC_PRC_LEVEL          = 0
TRC_SHM_LEVEL          = 0
TARGET_HOST            = "host_CL_01:28887"
COUNT_USERSV           = "HMpnCnt"
COUNT_SERVICEGRP       = "hmpn_cnt_srvgrp"
COUNT_SERVICE          = "hmpn_cnt_srv"
COUNT_WAIT_TIME        = 10
RDB_USERSV             = "HMpnRdb"
BL_AUTO_START          = "MANUAL"
AUTO_OPEN              = "MANUAL"
OPEN_RETRY_TIMES       = 1
OPEN_RETRY_INTERVAL    = 10
MPN_BL_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ol.env"
MPN_BL_SOFT_MQ_STT_SH  = "/var/mpncm/mq/ol/shsstmq.sh"
MPN_BL_SOFT_MQ_STP_SH  = "/var/mpncm/mq/ol/shsedmq.sh"
RAW_BL_STAT            = "/dev/vg/rlvbl01"
RAW_WORKPRC_STAT       = "/dev/vg/rlvbl02"
CHANNEL_NAME="TO.N0000000000:TO.N9999900000,TO.N0000000001:TO.N9999900000"
BL_ENV                 = "PDHOST=host_CL_01,",
                        "PDNAMEPORT=20000,PDUSER='"mpncls"/"mpncls"'"
CLUSTER_MODE           = "Y"
[HMPN/BL/CUP]
CUP_COUNT              = 12
[HMPN/BL/MON]
CTLCUP_WATCH_TIMER     = 30
CTLCUP_WATCH_COUNT     = 3
CTLCUP_TERM_WATCH_TIME = 10
BUSCUP_WATCH_TIMER     = 30
BUSCUP_WATCH_COUNT     = 3
BUSCUP_TERM_WATCH_TIME = 10
OPENTP1_WATCH_TIMER    = 30
OPENTP1_WATCH_COUNT    = 6

[HMPN/BL/SRV/99999000]
AUTO_START             = "AUTO"
REF_USERSV             = "HMpnRef"
REF_SERVICEGRP         = "hmpn_ref_srvgrp"
REF_SERVICE            = "hmpn_ref_srv"
PAY_USERSV             = "HMpnPay"
PAY_SERVICEGRP         = "hmpn_pay_srvgrp"
PAY_SERVICE            = "hmpn_pay_srv"
CAN_USERSV             = "HMpnCan"
CAN_SERVICEGRP         = "hmpn_can_srvgrp"
CAN_SERVICE            = "hmpn_can_srv"
RESEND_USERSV          = "HMpnRes"
RESEND_SERVICEGRP      = "hmpn_res_srvgrp"
RESEND_SERVICE         = "hmpn_res_srv"

[HMPN/BL/SRV/99999000/COM]
RPC_KIND               = "CALL"
[HMPN/BL/SRV/99999000/REF]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv"
[HMPN/BL/SRV/99999000/REF/101]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv101"
[HMPN/BL/SRV/99999000/REF/102]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv102"
[HMPN/BL/SRV/99999000/PAY]
SERVICEGRP             = "srvgrp"
SERVICE                = "pay_srv"
[HMPN/BL/SRV/99999000/CAN]
SERVICEGRP             = "srvgrp"
SERVICE                = "can_srv"
[HMPN/BL/SRV/99999000/RESEND]
SERVICEGRP             = "srvgrp"
SERVICE                = "resend_srv"

(2)　通信サーバBの記述例

[COMMON]
CENTER_CODE            = "GRPDST0001"
[HMPN/CODE]
OWN_NAME               = "sjis"
MPN_NAME               = "jis"
[HMPN/DB]
CONNECT_RETRY_TIMES    = 15
CONNECT_RETRY_INTERVAL = 1
[HMPN/BL]
TRC_FILE_SIZE          = 11000000
TRC_FILE_NUM           = 6
TRC_LEVEL              = 10
TRC_PRC_LEVEL          = 0
TRC_SHM_LEVEL          = 0
TARGET_HOST            = "host_CL_02:28888"
COUNT_USERSV           = "HMpnCnt"
COUNT_SERVICEGRP       = "hmpn_cnt_srvgrp"
COUNT_SERVICE          = "hmpn_cnt_srv"
COUNT_WAIT_TIME        = 10
RDB_USERSV             = "HMpnRdb"
BL_AUTO_START          = "MANUAL"
AUTO_OPEN              = "MANUAL"
OPEN_RETRY_TIMES       = 1
OPEN_RETRY_INTERVAL    = 10
MPN_BL_SOFT_ENV_FILE   = "/var/mpncm/conf/mpncm_ol.env"
MPN_BL_SOFT_MQ_STT_SH  = "/var/mpncm/mq/ol/shsstmq.sh"
MPN_BL_SOFT_MQ_STP_SH  = "/var/mpncm/mq/ol/shsedmq.sh"
RAW_BL_STAT            = "/dev/vg/rlvbl01"
RAW_WORKPRC_STAT       = "/dev/vg/rlvbl02"
CHANNEL_NAME="TO.N0000000000:TO.N9999900001,TO.N0000000001:TO.N9999900001"
BL_ENV                 = "PDHOST=host_CL_01,",
                        "PDNAMEPORT=20000,PDUSER='"mpncls"/"mpncls"'"
CLUSTER_MODE           = "Y"
[HMPN/BL/CUP]
CUP_COUNT              = 12
[HMPN/BL/MON]
CTLCUP_WATCH_TIMER     = 30
CTLCUP_WATCH_COUNT     = 3
CTLCUP_TERM_WATCH_TIME = 10
BUSCUP_WATCH_TIMER     = 30
BUSCUP_WATCH_COUNT     = 3
BUSCUP_TERM_WATCH_TIME = 10
OPENTP1_WATCH_TIMER    = 30
OPENTP1_WATCH_COUNT    = 6

[HMPN/BL/SRV/99999000]
AUTO_START             = "AUTO"
REF_USERSV             = "HMpnRef"
REF_SERVICEGRP         = "hmpn_ref_srvgrp"
REF_SERVICE            = "hmpn_ref_srv"
PAY_USERSV             = "HMpnPay"
PAY_SERVICEGRP         = "hmpn_pay_srvgrp"
PAY_SERVICE            = "hmpn_pay_srv"
CAN_USERSV             = "HMpnCan"
CAN_SERVICEGRP         = "hmpn_can_srvgrp"
CAN_SERVICE            = "hmpn_can_srv"
RESEND_USERSV          = "HMpnRes"
RESEND_SERVICEGRP      = "hmpn_res_srvgrp"
RESEND_SERVICE         = "hmpn_res_srv"

[HMPN/BL/SRV/99999000/COM]
RPC_KIND               = "CALL"
[HMPN/BL/SRV/99999000/REF]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv"
[HMPN/BL/SRV/99999000/REF/101]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv101"
[HMPN/BL/SRV/99999000/REF/102]
SERVICEGRP             = "srvgrp"
SERVICE                = "ref_srv102"
[HMPN/BL/SRV/99999000/PAY]
SERVICEGRP             = "srvgrp"
SERVICE                = "pay_srv"
[HMPN/BL/SRV/99999000/CAN]
SERVICEGRP             = "srvgrp"
SERVICE                = "can_srv"
[HMPN/BL/SRV/99999000/RESEND]
SERVICEGRP             = "srvgrp"
SERVICE                = "resend_srv"

5.　DBへのテーブルの作成

この章では，HiRDBにテーブルを作成する方法について説明します。

＜この章の構成＞

5.1　DBに作成するテーブルの種類

5.2　電文履歴格納用テーブルの作成

5.3　収納カウンタ情報格納用テーブルの作成

5.4　納付情報格納用テーブルの作成

5.5　請求情報格納用テーブルの作成

5.6　消込情報格納用テーブルの作成

5.7　対象金融機関情報格納用テーブルの作成

5.8　対象収納機関情報格納用テーブルの作成

5.9　障害情報格納用テーブルの作成

5.10　状態管理情報格納用テーブルの作成

5.11　国庫金納付情報格納用テーブルの作成

5.12　国庫金消込情報格納用テーブルの作成

5.13　国庫金対象金融機関情報格納用テーブルの作成

5.1　DBに作成するテーブルの種類

HiRDBに作成するテーブルの種類と，それぞれのテーブルの概要について説明します。

各収納サービス共通のテーブルと，収納サービスごと，および収納機関コードごとに分けて作成するテーブルがあります。収納サービスの種類に合わせて，必要なテーブルを作成してください。作成が必要なテーブルの一覧を次に示します。

表5-1　作成が必要なテーブル一覧

テーブル名 | 収納サービスの種類
地方税・地公体料金 | 一般料金 | 国庫金
電文履歴格納用テーブル | ○ | ○ | ○
収納カウンタ情報格納用テーブル | ◎ | ◎ | ◎
納付情報格納用テーブル | ○ | － | －
請求情報格納用テーブル | － | ○ | －
消込情報格納用テーブル | ○ | ○ | －
対象金融機関情報格納用テーブル | ○ | ○ | －
対象収納機関情報格納用テーブル | ◎ | ◎ | －
障害情報格納用テーブル | ◎ | ◎ | ◎
状態管理情報格納用テーブル※ | ◎ | ◎ | ◎
国庫金納付情報格納用テーブル | － | － | ○
国庫金消込情報格納用テーブル | － | － | ○
国庫金対象金融機関情報格納用テーブル | － | － | ○

（凡例）

◎：作成が必要なテーブル（各収納サービス共通のテーブル）

○：作成が必要なテーブル（収納サービスごと，および収納機関コードごとに分けて作成するテーブル）

－：該当なし

注※

クラスタ構成で構築，運用する場合だけに必要です。

各テーブルについて説明します。

電文履歴格納用テーブル
通信サーバfor BillerとMPNセンタとの間で送受信した電文の履歴が格納されます。なお，電文履歴格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。SQLファイルの項目は，地方税・地公体料金用，一般料金用，国庫金用で異なります。

収納カウンタ情報格納用テーブル
通信サーバfor BillerがMPNセンタから取得した収納カウンタ情報が格納されます。収納カウンタ情報には，通信サーバfor BillerとMPNセンタとの間の収納情報の集計値が含まれています。収納カウンタ情報格納用テーブルは，構築するシステムに一つだけ必要です。サンプルSQLファイルを編集して作成します。

納付情報格納用テーブル
通信サーバfor Billerに登録された納付情報が格納されます。納付情報には請求金額や期限などが含まれています。なお，納付情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。

請求情報格納用テーブル
通信サーバfor Billerに登録された請求情報が格納されます。請求情報には請求金額や期限などが含まれています。なお，請求情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。

消込情報格納用テーブル
料金の支払いによって，通信サーバfor Billerに登録された消込情報が格納されます。消込情報には処理日時や支払い方法などが含まれています。なお，消込情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。SQLファイルの項目は，地方税・地公体料金用と一般料金用で異なります。

対象金融機関情報格納用テーブル
収納業務の対象となる金融機関についての情報が格納されます。金融機関情報は，受信した照会，消込，取消依頼電文が，収納業務の対象となる金融機関から送信されたかどうかを判断するために使用されます。
通信サーバfor Billerでは，金融機関情報を基に，収納委託契約のある金融機関から送られた電文であるかどうかを確認します。そのため，収納機関の委託契約の内容に合った金融機関情報を設定したテーブルを作成する必要があります。
なお，対象金融機関情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。SQLファイルの項目は，地方税・地公体料金用と一般料金用で異なります。

対象収納機関情報格納用テーブル
通信サーバfor BillerがMPNセンタから受信した消込依頼電文，および再送確認電文に対する応答電文を作成する時に必要な，収納機関情報が格納されます。収納機関情報には収納機関名（カナ・漢字）が含まれます。
通信サーバfor Billerが応答電文を作成する際，処理を必要とする収納情報がDBにない場合，受信電文内の収納機関コードに対応するデフォルトの収納機関名として，収納機関情報を使用します。そのため，収納機関名を設定したテーブルを作成する必要があります。なお，この収納機関名は，通信サーバシステム定義に定義したすべての収納機関コードに対応しています。通信サーバシステム定義の収納機関コードを追加・削除した場合は，収納機関情報の変更コマンド（hmpnrcvctl）で収納機関情報を追加・削除してください。収納機関情報の変更コマンドについては，「10.3　コマンドの詳細　hmpnrcvctl（収納機関情報の変更）」を参照してください。
なお，対象収納機関情報格納用テーブルは，構築するシステムに一つだけ必要です。サンプルSQLファイルを編集して作成します。

障害情報格納用テーブル
電文履歴として取得されずに破棄される電文を不正電文情報と呼びます。MPNセンタからの依頼電文受信直後，および収納業務プログラム応答直後の不正電文情報がDBの障害情報格納用テーブルに格納されます。なお，障害情報格納用テーブルは，構築するシステムに一つだけ必要です。サンプルSQLファイルを編集して作成します。

状態管理情報格納用テーブル
クラスタ構成で構築，運用する場合だけに必要です。通信サーバfor Billerの開閉局制御用の情報が格納されます。なお，状態管理情報格納用テーブルは，構築するシステムに一つだけ必要です。サンプルSQLファイルを編集して作成します。

国庫金納付情報格納用テーブル
通信サーバfor Billerに登録された納付情報が格納されます。納付情報には請求金額や期限などが含まれています。なお，国庫金納付情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。

国庫金消込情報格納用テーブル
料金の支払いによって，通信サーバfor Billerに登録された消込情報が格納されます。消込情報には処理日時や支払い方法などが含まれています。なお，国庫金消込情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。

国庫金対象金融機関情報格納用テーブル
収納業務の対象となる金融機関についての情報が格納されます。金融機関情報は，受信した照会，消込，取消依頼電文が，収納業務の対象となる金融機関から送信されたかどうかを判断するために使用されます。
通信サーバfor Billerでは，金融機関情報を基に，収納委託契約のある金融機関から送られた電文であるかどうかを確認します。そのため，収納機関の委託契約の内容に合った金融機関情報を設定したテーブルを作成する必要があります。
なお，国庫金対象金融機関情報格納用テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに必要です。それぞれ，サンプルSQLファイルを編集して作成します。

5.2　電文履歴格納用テーブルの作成

電文履歴格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.2.1　作成手順

5.2.2　テーブルの形式

5.2.1　作成手順

電文履歴格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
電文の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアを作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNH99999000.sql，HMPNH88888000.sql，またはHMPNH00400000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。

地方税・地公体料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/public/

一般料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/general/

国庫金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/treasury/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
SQLファイルの内容を次に示します。太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNH99999000」，「HMPNH88888000」または「HMPNH00400000」
収納機関コードを次の形式で指定してください。

HMPNHyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

「PAY_CLS」
国庫金で収納機関コードが国税庁（00200000）の場合は，インデクス1に「PAY_CLS」を追加してください。

SQLファイルの項目は，地方税・地公体料金用，一般料金用，および国庫金用で異なります。各ファイルの内容を次に示します。

地方税・地公体料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNH99999000(
 BILLER_RTN_CODE CHAR(8),
 BILLER_MSG_ID   VARCHAR(48),
           ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNH99999000_UIDX1 ON HMPNH99999000(
 BILLER_MSG_ID DESC,
 PROC_RESULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNH99999000_IDX1 ON HMPNH99999000(
 CUST_NO,
 CONF_NO,
 PAY_CLS
) IN MPNAREA;

CREATE INDEX HMPNH99999000_IDX2 ON HMPNH99999000(
 SRC_CODE,
 SRC_PROCDATE,
 SRC_PROCNUM
) IN MPNAREA;

一般料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNH88888000(
 BILLER_RTN_CODE CHAR(8),
 BILLER_MSG_ID   VARCHAR(48),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNH88888000_UIDX1 ON HMPNH88888000(
 BILLER_MSG_ID DESC,
 PROC_RESULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNH88888000_IDX1 ON HMPNH88888000(
 CUST_NO,
 CONF_NO
) IN MPNAREA;

CREATE INDEX HMPNH88888000_IDX2 ON HMPNH88888000(
 SRC_CODE,
 SRC_PROCDATE,
 SRC_PROCNUM
) IN MPNAREA;

国庫金用（収納機関コードが国税庁（00200000）の場合）

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNH00200000(
 BILLER_RTN_CODE CHAR(8),
 BILLER_MSG_ID   VARCHAR(48),
   : (中略)
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNH00200000_UIDX1 ON HMPNH00200000(
 BILLER_MSG_ID DESC,
 PROC_RESULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNH00200000_IDX1 ON HMPNH00200000(
 CUST_NO,
 CONF_NO,
 PAY_CLS
) IN MPNAREA;

CREATE INDEX HMPNH00200000_IDX2 ON HMPNH00200000(
 SRC_CODE,
 SRC_PROCDATE,
 SRC_PROCNUM
) IN MPNAREA;

国庫金用（収納機関コードが国税庁（00200000）以外の場合）

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNH00400000(
 BILLER_RTN_CODE CHAR(8),
 BILLER_MSG_ID   VARCHAR(48),
   : (中略)
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNH00400000_UIDX1 ON HMPNH00400000(
 BILLER_MSG_ID DESC,
 PROC_RESULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNH00400000_IDX1 ON HMPNH00400000(
 CUST_NO,
 CONF_NO
) IN MPNAREA;

CREATE INDEX HMPNH00400000_IDX2 ON HMPNH00400000(
 SRC_CODE,
 SRC_PROCDATE,
 SRC_PROCNUM
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 電文履歴格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.2.2　テーブルの形式

電文履歴格納用テーブルの形式を次に示します。

表5-2　電文履歴格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

BILLER_RTN_CODE
リターンコード
CHAR
8
8

BILLER_MSG_ID
電文ID
VARCHAR
48
48

MSG_TYPE
電文種別コード
CHAR
4
4

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
お客様番号（納付番号）
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

PAY_CLS
納付区分※1
VARCHAR
16
16

SRC_CODE
仕向センタコード
CHAR
10
10

SRC_PROCDATE
仕向処理年月日
CHAR
8
8

SRC_PROCNUM
仕向処理通番
CHAR
8
8

MSG_BODY
電文
VARCHAR
5,297
5,297

RPC_FLAG※2
RPC結果フラグ
CHAR
1
1

PROC_RESULT※3
電文処理結果
CHAR
2
2

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
5,443
5,454

注※1

一般料金の場合，納付区分には「NULL」を設定してください。

国庫金で収納機関コードが国税庁（00200000）以外の場合，納付区分には「NULL」を設定してください。

注※2

通信サーバfor Billerが次の値を設定します。

MPNセンタからの受信電文の場合：0

収納業務プログラムから電文応答があった場合：0

業務系プロセスおよび収納業務プログラムへのRPCが失敗した場合：1

処理継続不可で電文を破棄する場合：0

注※3

通信サーバfor Billerが電文処理結果として設定する値と意味を次に示します。

00：要求，01：応答，90：破棄

5.3　収納カウンタ情報格納用テーブルの作成

収納カウンタ情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは一つだけ必要です。

＜この節の構成＞

5.3.1　作成手順

5.3.2　テーブルの形式

5.3.1　作成手順

収納カウンタ情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
収納カウンタ情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNC00000000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
SQLファイルの内容を次に示します。太字および下線で示している部分に，手順2で作成したRDエリア名を指定してください。これ以外の部分は，編集しないでください。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNC00000000(
 RECV_CODE     CHAR(8),
 CNT_ACQR_TYPE CHAR(1),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNC00000000_IDX1 ON HMPNC00000000(
 CNT_ACQR_TYPE,
 INQ_DATE DESC
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 収納カウンタ情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.3.2　テーブルの形式

収納カウンタ情報格納用テーブルの形式を次に示します。

表5-3　収納カウンタ情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CNT_ACQR_TYPE
カウンタ取得タイプ
CHAR
1
1

INQ_DATE
カウンタ照会年月日
CHAR
8
8

CNT_DATE1
カウンタ年月日1
CHAR
8
8

INQ_CNT1
照会件数1
CHAR
8
8

PAY_CNT1
消込件数1
CHAR
8
8

PAY_AMT1
消込金額1
CHAR
14
14

CAN_CNT1
取消件数1
CHAR
8
8

CAN_AMT1
取消金額1
CHAR
14
14

CNT_DATE2
カウンタ年月日2
CHAR
8
8

INQ_CNT2
照会件数2
CHAR
8
8

PAY_CNT2
消込件数2
CHAR
8
8

PAY_AMT2
消込金額2
CHAR
14
14

CAN_CNT2
取消件数2
CHAR
8
8

CAN_AMT2
取消金額2
CHAR
14
14

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
144
155

5.4　納付情報格納用テーブルの作成

納付情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。なお，テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.4.1　作成手順

5.4.2　テーブルの形式

5.4.1　作成手順

納付情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
納付情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNN99999000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql/public/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNN99999000」
収納機関コードを次の形式で指定してください。

HMPNNyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの内容を次に示します。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNN99999000(
 RECV_CODE          CHAR(8),
 CUST_NO            VARCHAR(20),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNN99999000_IDX1 ON HMPNN99999000(
 CUST_NO,
 PAY_CLS,
 ID_NO
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNN99999000_UIDX1 ON HMPNN99999000(
 CUST_NO,
 CONF_NO,
 PAY_CLS
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 納付情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.4.2　テーブルの形式

納付情報格納用テーブルの形式を次に示します。

表5-4　納付情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
お客様番号（納付番号）
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

PAY_CLS
納付区分
VARCHAR
16
16

OCR_INFO
OCR情報
CHAR
83
83

BARCODE_INFO
バーコード情報
VARCHAR
50
50

PAY_FORM
支払形態
CHAR
1
1

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
24

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
12

PASSWD
パスワード
VARCHAR
20
20

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

ID_NO
識別番号
CHAR
20
20

PAY_DOC_TYPE
払込書区分
CHAR
1
1

PAY_TOTAL
納付合計額
CHAR
11
11

PAY_AMT
納付額
CHAR
11
11

ARRE_SHOW_TYPE
延滞金表示区分
CHAR
1
1

OVERDUE
延滞金
CHAR
8
8

COMM_BRDN_TYPE
手数料負担区分
CHAR
1
1

PAY_CONT_KANA
納付内容（カナ）
CHAR
24
24

PAY_CONT_KANJI
納付内容（漢字）
NCHAR
24
12

DEMAND
督促手数料
CHAR
11
11

PREPAID
前納報奨金
CHAR
11
11

PUBLIC_OPTION
地公体任意情報
VARCHAR
20
20

CHARGE_TYPE
手数料負担区分
CHAR
1
1

PAY_LIMIT_DATE
消込期限年月日
CHAR
8
8

PAY_MTHD
納付方式
CHAR
1
1

DETAIL_PRNT_KANA
詳細印字（カナ）
CHAR
24
24

DETAIL_PRNT_KANJI
詳細印字（漢字）
NCHAR
24
12

DETAIL_SHOW1_KANA
詳細表示1（カナ）
VARCHAR
150
150

DETAIL_SHOW1_KANJI
詳細表示1（漢字）
NVARCHAR
150
75

DETAIL_SHOW2_KANA
詳細表示2（カナ）
VARCHAR
150
150

DETAIL_SHOW2_KANJI
詳細表示2（漢字）
NVARCHAR
150
75

PAY_YEAR
納付年度
CHAR
4
4

PAY_STP_INFO
支払停止情報
CHAR
1
1

PAY_STP_CHANNEL
支払停止チャネル
CHAR
1
1

NONPYA_SHOW_INFO
未納表示情報
CHAR
1
1

EXTRA_INFO
期割情報
CHAR
2
2

REPLACE_INFO
差替情報
CHAR
1
1

PAID_FLAG
支払済フラグ
CHAR
1
1

CAN_FLAG
取消停止フラグ
CHAR
1
1

YOBI※1
予備
CHAR
360
360

PAY_CNT※2
消込カウンタ
INT
4
10

CAN_CNT※2
取消カウンタ
INT
4
10

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
1,488
1,313

注※1

任意で使用できる領域です。

注※2

「消込カウンタの値－取消カウンタの値＞＝2」が成立した場合，2回以上支払われている可能性があります。

5.5　請求情報格納用テーブルの作成

請求情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.5.1　作成手順

5.5.2　テーブルの形式

5.5.1　作成手順

請求情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
請求情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNS88888000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql/general/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNS88888000」
収納機関コードを次の形式で指定してください。

HMPNSyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの内容を次に示します。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNS88888000(
 RECV_CODE          CHAR(8),
 CUST_NO            VARCHAR(20),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNS88888000_IDX1 ON HMPNS88888000(
 CUST_NO,
 BILL_NO
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNS88888000_UIDX1 ON HMPNS88888000(
 CUST_NO,
 CONF_NO
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 請求情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.5.2　テーブルの形式

請求情報格納用テーブルの形式を次に示します。

表5-5　請求情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
お客様番号
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

OCR_INFO
OCR情報
CHAR
83
83

BARCODE_INFO
バーコード情報
VARCHAR
50
50

PAY_FORM
支払形態
CHAR
1
1

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
24

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
12

PASSWD
パスワード
VARCHAR
20
20

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

BILL_NO
請求番号
CHAR
20
20

PAY_DOC_TYPE
払込書区分
CHAR
1
1

BILL_TOTAL
請求金額
CHAR
11
11

BILL_PRINCIPAL
請求金額元金
CHAR
11
11

OVERDUE_DISP
延滞金表示区分
CHAR
1
1

OVERDUE
延滞金
CHAR
8
8

TAX_DISP
消費税額表示区分
CHAR
1
1

TAX
消費税額
CHAR
10
10

COMM_BRDN_TYPE
手数料負担区分
CHAR
1
1

BILL_CONT_KANA
請求内容（カナ）
CHAR
24
24

BILL_CONT_KANJI
請求内容（漢字）
NCHAR
24
12

CHARGE_TYPE
手数料負担区分
CHAR
1
1

PAY_LIMIT_DATE
消込期限年月日
CHAR
8
8

DETAIL_PRNT_KANA
詳細印字（カナ）
CHAR
24
24

DETAIL_PRNT_KANJI
詳細印字（漢字）
NCHAR
24
12

DETAIL_SHOW1_KANA
詳細表示1（カナ）
VARCHAR
150
150

DETAIL_SHOW1_KANJI
詳細表示1（漢字）
NVARCHAR
150
75

DETAIL_SHOW2_KANA
詳細表示2（カナ）
VARCHAR
150
150

DETAIL_SHOW2_KANJI
詳細表示2（漢字）
NVARCHAR
150
75

PAY_YEAR
請求年度
CHAR
4
4

PAY_STP_INFO
支払停止情報
CHAR
1
1

PAY_STP_CHANNEL
支払停止チャネル
CHAR
1
1

NONPYA_SHOW_INFO
未納表示情報
CHAR
1
1

EXTRA_INFO
ソート情報
CHAR
2
2

REPLACE_INFO
差替情報
CHAR
1
1

PAID_FLAG
支払済フラグ
CHAR
1
1

CAN_FLAG
取消停止フラグ
CHAR
1
1

YOBI※1
予備
CHAR
360
360

PAY_CNT※2
消込カウンタ
INT
4
10

CAN_CNT※2
取消カウンタ
INT
4
10

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
1,440
1,265

注※1

任意で使用できる領域です。

注※2

「消込カウンタの値－取消カウンタの値＞＝2」が成立した場合，2回以上支払われている可能性があります。

5.6　消込情報格納用テーブルの作成

消込情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.6.1　作成手順

5.6.2　テーブルの形式

5.6.1　作成手順

消込情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
消込情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNK99999000.sql，またはHMPNK88888000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。

地方税・地公体料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/public/

一般料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/general/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNK99999000」または「HMPNK88888000」
収納機関コードを次の形式で指定してください。

HMPNKyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの項目は，地方税・地公体料金用と一般料金用で異なります。各ファイルの内容を次に示します。

地方税・地公体料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNK99999000(
 RECV_CODE       CHAR(8),
 CUST_NO         VARCHAR(20),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNK99999000_IDX1 ON HMPNK99999000(
 CUST_NO,
                ：（中略）
) IN MPNAREA;

CREATE INDEX HMPNK99999000_IDX2 ON HMPNK99999000(
 PAY_DATE DESC
) IN MPNAREA;

一般料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNK88888000(
 RECV_CODE       CHAR(8),
 CUST_NO         VARCHAR(20),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNK88888000_IDX1 ON HMPNK88888000(
 CUST_NO,
                ：（中略）
) IN MPNAREA;

CREATE INDEX HMPNK88888000_IDX2 ON HMPNK88888000(
 PAY_DATE DESC
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 消込情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.6.2　テーブルの形式

消込情報格納用テーブルの形式を次に示します。

表5-6　消込情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
お客様番号（納付番号）
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

PAY_CLS
納付区分※
VARCHAR
16
16

SRC_TRX
仕向トランザクション番号
CHAR
5
5

DST_TRX
被仕向トランザクション番号
CHAR
5
5

SRC_CODE
仕向センタコード
CHAR
10
10

DST_CODE
被仕向センタコード
CHAR
10
10

BANK_CODE
金融機関コード
CHAR
8
8

BRANCH_CODE
店舗コード
CHAR
6
6

SRC_PROCDATE
仕向処理年月日
CHAR
8
8

SRC_PROCTIME
仕向処理時刻
CHAR
6
6

SRC_PROCNUM
仕向処理通番
CHAR
8
8

MPN_PROCDATE
MPN処理年月日
CHAR
8
8

MPN_PROCTIME
MPN処理時刻
CHAR
6
6

MPN_PROCNUM
MPN処理通番
CHAR
10
10

PAYMENT
精査金額
CHAR
11
11

ORIGIN_MSG_TYPE
オリジナル電文種別コード
CHAR
4
4

ORIGIN_RES_CODE
オリジナルレスポンスコード
CHAR
4
4

RES_CODE
レスポンスコード
CHAR
4
4

AGENCY_CODE
歳入代理店金融機関コード
CHAR
8
8

CHANNEL_TYPE
チャネル区分
CHAR
2
2

PAY_TYPE
納付金区分
CHAR
2
2

IN_TYPE
入力区分
CHAR
2
2

OCR_INFO
OCR情報
CHAR
83
83

BARCODE_INFO
バーコード情報
VARCHAR
50
50

PAY_FORM
支払い形態
CHAR
1
1

BILL_INFO
請求情報
VARCHAR
115
115

IS_INQ
照会有無
CHAR
1
1

RECEIPT_DATE
入金日
CHAR
8
8

CHECK_AMT
他店券金額
CHAR
11
11

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
24

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
12

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

PAY_WAY
支払方法
CHAR
1
1

STAMP_AMT
印紙税額
CHAR
3
3

BANK_OPTION
金融機関任意情報
VARCHAR
20
20

PAY_AMT
収納金額
CHAR
11
11

PAY_DATE
収納日
CHAR
8
8

INQ_TIME
照会時刻
CHAR
6
6

RECEIPT_TYPE
領収区分
CHAR
1
1

PAY_INFO
納付情報
VARCHAR
132
132

PUBLIC_OPTION
地公体任意情報
VARCHAR
20
20

CAN_FLAG
取消フラグ
CHAR
1
1

RTN_INFO
リターン情報
CHAR
8
8

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
760
747

注※

一般料金の場合，納付区分には「NULL」を設定してください。

5.7　対象金融機関情報格納用テーブルの作成

対象金融機関情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.7.1　作成手順

5.7.2　テーブルの形式

5.7.1　作成手順

対象金融機関情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
金融機関情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNB99999000.sql，またはHMPNB88888000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。

地方税・地公体料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/public/

一般料金用

（通信サーバfor Billerセットアップディレクトリ）/examples/sql/general/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNB99999000」または「HMPNB88888000」
収納機関コードを次の形式で指定してください。

HMPNByyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの項目は，地方税・地公体料金用と一般料金用で異なります。各ファイルの内容を次に示します。

地方税・地公体料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNB99999000(
 RECV_CODE       CHAR(8),
 TAX_CLS         CHAR(3),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNB99999000_UIDX1 ON HMPNB99999000(
 TAX_CLS,
 BANK_CODE,
                ：（中略）
) IN MPNAREA;

一般料金用

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNB88888000(
 RECV_CODE       CHAR(8),
 TAX_CLS         CHAR(3),
                ：（中略）
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNB88888000_UIDX1 ON HMPNB88888000(
 BANK_CODE,
                ：（中略）
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 対象金融機関情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.7.2　テーブルの形式

対象金融機関情報格納用テーブルの形式を次に示します。

表5-7　対象金融機関情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

TAX_CLS
取り扱いできる税目・料金番号※
CHAR
3
3

BANK_CODE
委託契約のある金融機関コード
CHAR
8
8

BRANCH_CODE
金融機関の店舗コード，または法人などで使用する仮想の店舗コード
CHAR
6
6

CHANNEL_TYPE
取り扱いできるチャネル区分
CHAR
2
2

START_DATE
委託契約のある金融機関の適用開始年月日
CHAR
8
8

STOP_DATE
委託契約のある金融機関の適用終了年月日
CHAR
8
8

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
50
61

注※

すべての税目・料金番号に共通する場合，ALL0を設定してください。また，一般料金の場合，「NULL」を設定してください。

5.8　対象収納機関情報格納用テーブルの作成

対象収納機関情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは一つだけ必要です。

＜この節の構成＞

5.8.1　作成手順

5.8.2　テーブルの形式

5.8.1　作成手順

対象収納機関情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
収納機関情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNR.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
SQLファイルの内容を次に示します。太字および下線で示している部分に，手順2で作成したRDエリア名を指定してください。これ以外の部分は，編集しないでください。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNR(
 RECV_CODE       CHAR(8),
 RECV_NAME_KANA  VARCHAR(24),
 RECV_NAME_KANJI NVARCHAR(12),
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNR_UIDX1 ON HMPNR(
 RECV_CODE
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 対象収納機関情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.8.2　テーブルの形式

対象収納機関情報格納用テーブルの形式を次に示します。

表5-8　対象収納機関情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
63
62

5.9　障害情報格納用テーブルの作成

障害情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは一つだけ必要です。

＜この節の構成＞

5.9.1　作成手順

5.9.2　テーブルの形式

5.9.1　作成手順

障害情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
不正電文情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNERROR.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
SQLファイルの内容を次に示します。太字および下線で示している部分に，手順2で作成したRDエリア名を指定してください。これ以外の部分は，編集しないでください。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNERROR(
 BILLER_MSG_ID  VARCHAR(48),
 ERROR_INF      VARCHAR(5395),
 PROD_DATE      DATE NOT NULL WITH DEFAULT,
 PROD_TIME      TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 障害情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.9.2　テーブルの形式

障害情報格納用テーブルの形式を次に示します。

表5-9　障害情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

BILLER_MSG_ID
電文ID
VARCHAR
48
48

ERROR_INF
不正電文情報
VARCHAR
5,395
5,395

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
5,450
5,461

5.10　状態管理情報格納用テーブルの作成

状態管理情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは一つだけ必要です。

＜この節の構成＞

5.10.1　作成手順

5.10.2　テーブルの形式

5.10.1　作成手順

状態管理情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
状態管理情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNSTINFO.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
SQLファイルの内容を次に示します。太字および下線で示している部分に，手順2で作成したRDエリア名を指定してください。これ以外の部分は，編集しないでください。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNSTINFO(
 MPN_STATUS    CHAR(1),
 PRC_FLAG      INT,
                ：（中略）
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 状態管理情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.10.2　テーブルの形式

状態管理情報格納用テーブルの形式を次に示します。

表5-10　状態管理情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

MPN_STATUS
開閉局状態
CHAR
1
1

PRC_FLAG
処理中プロセスフラグ
INT
4
10

ACCESS_DATE
アクセス日
DATE
4
10

ACCESS_TIME
アクセス時間
TIME
3
8

RENEW_DATE
更新日
DATE
4
10

RENEW_TIME
更新時間
TIME
3
8

RENEW_SERV
更新サーバ
VARCHAR
63
63

合計
82
110

5.11　国庫金納付情報格納用テーブルの作成

国庫金納付情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。なお，テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.11.1　作成手順

5.11.2　テーブルの形式

5.11.1　作成手順

国庫金納付情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
納付情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNT00400000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql/treasury/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNT00400000」
収納機関コードを次の形式で指定してください。

HMPNNyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの内容を次に示します。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNT00400000(
 RECV_CODE          CHAR(8),
 CUST_NO            VARCHAR(20),
　： (中略)
 PROD_DATE          DATE NOT NULL WITH DEFAULT,
 PROD_TIME          TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNT00400000_UIDX1 ON HMPNT00400000(
 CUST_NO,
 CONF_NO,
 PAY_CLS
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 国庫金納付情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.11.2　テーブルの形式

国庫金納付情報格納用テーブルの形式を次に示します。

表5-11　国庫金納付情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
納付番号
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

PAY_CLS
納付区分※1
VARCHAR
16
16

OCR_INFO
OCR情報
CHAR
83
83

BARCODE_INFO
バーコード情報
VARCHAR
50
50

PAY_FORM
支払形態
CHAR
1
1

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
24

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
12

PASSWD
パスワード
VARCHAR
20
20

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

PAY_DETAIL_KANA
支払内容（カナ）
CHAR
24
24

PAY_DETAIL_KANJI
支払内容（漢字）
NCHAR
24
12

TREASURY_DISP
国庫金画面区分
CHAR
1
1

TREASURY_AMT
支払金額
CHAR
11
11

CAPITAL
内元本
CHAR
11
11

OVERDUE_DISP
内延滞金表示区分
CHAR
1
1

OVERDUE
内延滞金
CHAR
11
11

CHARGE_DISP
内手数料表示区分
CHAR
1
1

CHARGE
内手数料
CHAR
11
11

DEMAND
督促手数料
CHAR
11
11

PREPAID
前納報奨金
CHAR
11
11

TREASURY_OPTION
国庫金任意情報
VARCHAR
40
40

CHARGE_TYPE
手数料負担区分
CHAR
1
1

PAY_LIMIT_DATE
消込期限年月日
CHAR
8
8

PAY_MTHD
納付方式
CHAR
1
1

DETAIL_PRNT_KANA
詳細印字（カナ）
CHAR
24
24

DETAIL_PRNT_KANJI
詳細印字（漢字）
NCHAR
24
12

DETAIL_SHOW1_KANA
詳細表示１（カナ）
VARCHAR
150
150

DETAIL_SHOW1_KANJI
詳細表示１（漢字）
NVARCHAR
150
75

DETAIL_SHOW2_KANA
詳細表示２（カナ）
VARCHAR
150
150

DETAIL_SHOW2_KANJI
詳細表示２（漢字）
NVARCHAR
150
75

PAY_YEAR
納付年度
CHAR
4
4

PAY_STP_INFO
支払停止情報
CHAR
1
1

PAY_STP_CHANNEL
支払停止チャネル
CHAR
1
1

NONPYA_SHOW_INFO
未納表示情報
CHAR
1
1

EXTRA_INFO
期割情報
CHAR
2
2

REPLACE_INFO
差替情報
CHAR
1
1

PAID_FLAG
支払済フラグ
CHAR
1
1

CAN_FLAG
取消停止フラグ
CHAR
1
1

YOBI※2
予備
VARCHAR
360
360

PAY_CNT※3
消込カウンタ
INT
4
10

CAN_CNT※3
取消カウンタ
INT
4
10

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
1,502
1,327

注※1

収納機関コードが国税庁（00200000）以外の場合，納付区分には「NULL」を設定してください。

注※2

任意で使用できる領域です。

注※3

「消込カウンタの値－取消カウンタの値＞＝2」が成立した場合，2回以上支払われている可能性があります。

消込カウンタ，および取消カウンタの初期値として「0」を設定してください。初期値が設定されていない場合，消込処理などでエラーが発生することがあります。

5.12　国庫金消込情報格納用テーブルの作成

国庫金消込情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.12.1　作成手順

5.12.2　テーブルの形式

5.12.1　作成手順

国庫金消込情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
消込情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNK00400000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql/treasury/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNK00400000」
収納機関コードを次の形式で指定してください。

HMPNKyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

SQLファイルの内容を次に示します。

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNK00400000(
 RECV_CODE       CHAR(8),
 CUST_NO         VARCHAR(20),
　： (中略)
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE INDEX                                                         */
/*======================================================================*/
CREATE INDEX HMPNK00400000_IDX1 ON HMPNK00400000(
 CUST_NO,
 CONF_NO,
 PAY_CLS,
 SRC_CODE,
 SRC_PROCDATE,
 SRC_PROCNUM
) IN MPNAREA;

CREATE INDEX HMPNK00400000_IDX2 ON HMPNK00400000(
 PAY_DATE DESC
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 国庫金消込情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.12.2　テーブルの形式

国庫金消込情報格納用テーブルの形式を次に示します。

表5-12　国庫金消込情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

CUST_NO
納付番号
VARCHAR
20
20

CONF_NO
確認番号
VARCHAR
6
6

PAY_CLS
納付区分※
VARCHAR
16
16

SRC_TRX
仕向トランザクション番号
CHAR
5
5

DST_TRX
被仕向トランザクション番号
CHAR
5
5

SRC_CODE
仕向センタコード
CHAR
10
10

DST_CODE
被仕向センタコード
CHAR
10
10

BANK_CODE
金融機関コード
CHAR
8
8

BRANCH_CODE
店舗コード
CHAR
6
6

SRC_PROCDATE
仕向処理年月日
CHAR
8
8

SRC_PROCTIME
仕向処理時刻
CHAR
6
6

SRC_PROCNUM
仕向処理通番
CHAR
8
8

MPN_PROCDATE
MPN処理年月日
CHAR
8
8

MPN_PROCTIME
MPN処理時刻
CHAR
6
6

MPN_PROCNUM
MPN処理通番
CHAR
10
10

PAYMENT
精査金額
CHAR
11
11

ORIGIN_MSG_TYPE
オリジナル電文種別コード
CHAR
4
4

ORIGIN_RES_CODE
オリジナルレスポンスコード
CHAR
4
4

RES_CODE
レスポンスコード
CHAR
4
4

AGENCY_CODE
歳入代理店金融機関コード
CHAR
8
8

CHANNEL_TYPE
チャネル区分
CHAR
2
2

PAY_TYPE
納付金区分
CHAR
2
2

IN_TYPE
入力区分
CHAR
2
2

OCR_INFO
OCR情報
CHAR
83
83

BARCODE_INFO
バーコード情報
VARCHAR
50
50

PAY_FORM
支払形態
CHAR
1
1

BILL_INFO
請求情報
VARCHAR
115
115

IS_INQ
照会有無
CHAR
1
1

RECEIPT_DATE
入金日
CHAR
8
8

CHECK_AMT
他店券金額
CHAR
11
11

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
24

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
12

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
24

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
12

PAY_WAY
支払方法
CHAR
1
1

STAMP_AMT
印紙税額
CHAR
3
3

BANK_OPTION
金融機関任意情報
VARCHAR
20
20

PAY_AMT
収納金額
CHAR
11
11

PAY_DATE
収納日
CHAR
8
8

INQ_TIME
照会時刻
CHAR
6
6

RECEIPT_TYPE
領収区分
CHAR
1
1

PAY_INFO
納付情報
VARCHAR
132
132

PUBLIC_OPTION
地公体任意情報
VARCHAR
20
20

CAN_FLAG
取消フラグ
CHAR
1
1

RTN_INFO
リターン情報
CHAR
8
8

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
760
747

注※

収納機関コードが国税庁（00200000）以外の場合，納付区分には「NULL」を設定してください。

5.13　国庫金対象金融機関情報格納用テーブルの作成

国庫金対象金融機関情報格納用テーブルの作成手順，および作成するテーブルの形式について説明します。テーブルは，通信サーバシステム定義に定義してある収納機関コードごとに作成してください。

＜この節の構成＞

5.13.1　作成手順

5.13.2　テーブルの形式

5.13.1　作成手順

国庫金対象金融機関情報格納用テーブルは，次の手順で作成します。なお，テーブルは，スキーマ定義権限を持ったユーザーが作成してください。

RDエリアの容量を見積もる
金融機関情報の格納に必要となるRDエリアの容量を見積もってください。RDエリアの容量の見積もり方法については，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

RDエリアを作成する
手順1で見積もった容量のRDエリアをHiRDBに作成してください。RDエリアの作成手順については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

サンプルSQLファイル（HMPNB00400000.sql）を任意のディレクトリにコピーする
サンプルSQLファイルは，次のディレクトリに格納されています。
（通信サーバfor Billerセットアップディレクトリ）/examples/sql/treasury/

SQLファイルを編集する
コピーしたSQLファイルを編集して，テーブル作成用SQLファイルを作成してください。
太字および下線で示している部分を次のとおりに編集してください。これ以外の部分は，編集しないでください。

「MPNAREA」
手順2で作成したRDエリア名を指定してください。

「HMPNB00400000」
収納機関コードを次の形式で指定してください。

HMPNByyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

「PAY_CLS」
国庫金で収納機関コードが国税庁（00200000）の場合は，インデクス1に「PAY_CLS」を追加してください。

SQLファイルの内容を次に示します。

収納機関コードが国税庁（00200000）の場合

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNB00200000(
 RECV_CODE       CHAR(8),
 PAY_CLS         VARCHAR(16),
   : (中略)
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNB00200000_UIDX1 ON HMPNB00200000(
 PAY_CLS,
 AGENCY_CODE,
 BRANCH_CODE,
 CHANNEL_TYPE
) IN MPNAREA;

収納機関コードが国税庁（00200000）以外の場合

/*======================================================================*/
/* CREATE TABLE                                                         */
/*======================================================================*/
CREATE TABLE HMPNB00400000(
 RECV_CODE       CHAR(8),
 PAY_CLS         VARCHAR(16),
   : (中略)
 PROD_DATE       DATE NOT NULL WITH DEFAULT,
 PROD_TIME       TIME NOT NULL WITH DEFAULT
) IN MPNAREA;

/*======================================================================*/
/* CREATE UNIQUE INDEX                                                  */
/*======================================================================*/
CREATE UNIQUE INDEX HMPNB00400000_UIDX1 ON HMPNB00400000(
 AGENCY_CODE,
 BRANCH_CODE,
 CHANNEL_TYPE
) IN MPNAREA;

HiRDBのデータベース定義ユティリティ（pddef）を実行する
次の形式で，データベース定義ユティリティを実行してください。引数には，手順4で作成したSQLファイル名を指定します。

%pddef < 国庫金対象金融機関情報格納用テーブル作成SQLファイル名

データベース定義ユティリティの詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

5.13.2　テーブルの形式

国庫金対象金融機関情報格納用テーブルの形式を次に示します。

表5-13　国庫金対象金融機関情報格納用テーブルの形式

項目名
内容
DB属性
サイズ
（単位：バイト）
桁数

RECV_CODE
収納機関コード
CHAR
8
8

PAY_CLS
納付区分※
VARCHAR
16
16

AGENCY_CODE
歳入代理店金融機関コード
CHAR
8
8

BRANCH_CODE
店舗コード
CHAR
6
6

CHANNEL_TYPE
チャネル区分
CHAR
2
2

START_DATE
適用開始年月日
CHAR
8
8

STOP_DATE
適用終了年月日
CHAR
8
8

PROD_DATE
作成日
DATE
4
10

PROD_TIME
作成時刻
TIME
3
8

合計
63
74

注※

収納機関コードが国税庁（00200000）以外の場合，納付区分には「NULL」を設定してください。

6.　ユーザーコールバックの作成

この章では，ユーザーコールバックの役割，作成手順などについて説明します。ユーザーコールバックは，必要に応じて作成および使用してください。

＜この章の構成＞

6.1　ユーザーコールバックの役割

6.2　ユーザーコールバックが呼び出されるタイミング

6.3　サンプルファイル使用時のデータ解析方法

6.4　作成手順

6.5　ユーザーコールバックインターフェース

6.1　ユーザーコールバックの役割

ユーザーコールバックとは，ユーザー固有の処理をするために，ユーザーが処理をコーディングする部分のことです。通信サーバfor Billerでは，ユーザーコールバックとして，データ解析機能を提供しています。データ解析機能を使用すると，OCR情報やバーコード情報などのユーザー独自のデータから，「お客様番号（納付番号）」，「確認番号」，「納付区分」や「地公体任意情報」などを取得できます。

6.2　ユーザーコールバックが呼び出されるタイミング

データ解析機能のユーザーコールバックは，次の場合に呼び出され，実行されます。

業務電文受信CUP

消込情報ファイルの変換（コマンド）

ユーザーコールバックが呼び出されるタイミングを次に示します。

図6-1　ユーザーコールバックが呼び出されるタイミング（業務電文受信CUP）

注※1

バーコード情報のデータ解析の場合，ユーザーコールバックを必ず作成してください。

注※2

解析する情報については，「6.3　サンプルファイル使用時のデータ解析方法」を参照してください。

注※3

制御ヘッダー部の付与には，「お客様番号（納付番号）」，「確認番号」および「納付区分」が必要です。電文の構成については，「1.6　通信サーバfor Billerが送受信する電文」を参照してください。また，制御ヘッダー部のフォーマットについては，「付録B　制御ヘッダー部のフォーマット」を参照してください。

図6-2　ユーザーコールバックが呼び出されるタイミング（消込情報ファイルの変換）

注※1

バーコード情報のデータ解析の場合，ユーザーコールバックを必ず作成してください。

注※2

解析する情報については，「6.3　サンプルファイル使用時のデータ解析方法」を参照してください。

消込情報ファイルの変換については，「8.4.4　消込情報ファイルの変換」および「10.3　コマンドの詳細　hmpnpayfile（消込情報ファイルの変換）」を参照してください。

6.3　サンプルファイル使用時のデータ解析方法

通信サーバfor Billerでは，データ解析機能のユーザーコールバックのサンプルファイルを提供しています。サンプルファイルを使用する場合，ユーザーコールバックの作成は不要です。ただし，サンプルファイルでデータ解析機能を使用する場合は，次の点に注意してください。

地方税・地公体料金，および一般料金のサンプルファイルは，OCR情報だけに対応しています。サンプルファイルをバーコード情報で使用するとエラーになります。
このため，バーコード情報を解析する場合は，ユーザーで規定したバーコード情報を基に，解析処理を作成してください。

国庫金のサンプルファイルでは，解析処理を記述していないため，解析処理で使用するとエラーになります。
このため，ユーザーで規定したOCR情報やバーコード情報を基に，解析処理を作成してください。

ユーザーコールバックで取得する情報の詳細については，「6.5　ユーザーコールバックインターフェース」を参照してください。

地方税・地公体料金，および一般料金のサンプルファイル使用時のデータ解析方法を次に示します。

表6-1　サンプルファイル使用時のデータ解析方法（地方税・地公体料金の場合）

取得する情報 | データ解析方法
納付番号 | OCR情報の42バイト目から20バイトを取得します。
確認番号 | OCR情報の62バイト目から6バイトを取得します。
納付区分 | OCR情報の32バイト目から3バイトを取得します。
地公体任意情報 | OCR情報の68バイト目から16バイトを取得します。

表6-2　サンプルファイル使用時のデータ解析方法（一般料金の場合）

取得する情報 | データ解析方法
お客様番号 | OCR情報の42バイト目から20バイトを取得します。
確認番号 | OCR情報の62バイト目から6バイトを取得します。

6.4　作成手順

ユーザーコールバック作成時の注意および作成方法について説明します。

＜この節の構成＞

6.4.1　作成時の注意

6.4.2　作成方法

6.4.1　作成時の注意

通信サーバfor Billerでは，地方税・地公体料金，一般料金および国庫金で，それぞれデータ解析機能のユーザーコールバックを提供しています。サンプルファイルを基にライブラリを作成した場合，データ解析機能のユーザーコールバックとして，独自の処理ができます。そのため，ユーザーコールバックは，ユーザーの目的に合わせ作成してください。

6.4.2　作成方法

ユーザーコールバックは次の手順で作成します。なお，ユーザーコールバックは，通信サーバ管理者が作成してください。

サンプルファイルを任意のディレクトリにコピーする
サンプルファイルは，次のディレクトリに格納されています。

地方税・地公体料金の場合

（通信サーバfor Billerセットアップディレクトリ）/examples/uoc/public/

一般料金の場合

（通信サーバfor Billerセットアップディレクトリ）/examples/uoc/general/

国庫金の場合

（通信サーバfor Billerセットアップディレクトリ）/examples/uoc/treasury/

このディレクトリには，次のサンプルファイルが格納されています。

表6-3　ユーザーコールバックのサンプルファイル

ファイル名 | 種別
HMpnUoc.c | サンプルファイル
HMpnUoc.h | ヘッダーファイル
Makefile | メイクファイル

なお，サンプルファイルは，直接編集しないでください。必ずコピーしたサンプルファイルを使用してください。

ファイルの属性を変更する
コピーしたファイルに，書き込み権限を追加してください。

コピーしたファイルを編集し，処理を追加する
ユーザーコールバックの仕様については，「6.5　ユーザーコールバックインターフェース」を参照してください。

サンプルメイクファイルを編集する
ライブラリを生成するために，ユーザーコールバックを作成する環境に応じて，サンプルメイクファイルを編集します。

ライブラリを生成する
次の形式で，メイクを実行してください。

% make

メイクを実行すると，ライブラリが生成されます。生成されるライブラリは，次のとおりです。

表6-4　ユーザーコールバックのライブラリ

ファイル名
種別

AIX 5Lの場合
libhmpnuoc.a

HP-UXの場合
libhmpnuoc.sl

地方税・地公体料金用ライブラリ

AIX 5Lの場合
libhmpnuocgen.a

HP-UXの場合
libhmpnuocgen.sl

一般料金用ライブラリ

AIX 5Lの場合
libhmpnuoctrs.a

国庫金用ライブラリ

通信サーバfor Billerが稼働中の場合，停止する
状態表示コマンド（hmpnstat）を実行して，通信サーバfor Billerが稼働中かどうかを確認します。通信サーバfor Billerが稼働中であれば，停止してください。なお，通信サーバfor Billerが開局中の場合は，閉局コマンド（hmpnclose）を実行して閉局してから，停止してください。
通信サーバfor Billerの停止方法については，「8.2.7　通信サーバfor Billerの停止」を参照してください。

生成したライブラリを所定のディレクトリにコピーする
次の形式で，手順5で生成したライブラリを（通信サーバfor Billerのセットアップディレクトリ）/usrlibにコピーしてください。なお，コピーする前に，同じ名前のライブラリがコピー先ディレクトリに存在しないことを確認してください。
ここでは，地方税・地公体料金用ライブラリを生成したときの例を示します。

# cp libhmpnuoc.sl $HMPNDIR/usrlib

通信サーバ管理者でログインする
通信サーバfor Billerを起動するために，通信サーバ管理者でログインしてください。

通信サーバfor Billerを起動する
通信サーバfor Billerの起動方法については，「8.2.2　通信サーバfor Billerの起動」を参照してください。

注意

独自に作成したライブラリを，通信サーバfor Billerが提供するライブラリに変更する場合，所定のディレクトリにあるライブラリを必ず削除し，その後ファイル初期化コマンド（hmpnblinit）を実行してください。

独自のライブラリを，マルチスレッドライブラリとして作成することはできません。

6.5　ユーザーコールバックインターフェース

ユーザーコールバックインターフェースは，通信サーバfor Billerのデータ解析機能のためのインターフェースです。電文の情報から「お客様番号（納付番号）」，「確認番号」，「納付区分」および「地公体任意情報」を取り出す場合，ユーザーコールバックインターフェースを使用して，ユーザーコールバックを呼び出してください。

ユーザーコールバックインターフェースには，地方税・地公体料金用，一般料金用および国庫金用があります。

＜この節の構成＞

6.5.1　ユーザーコールバックインターフェース（地方税・地公体料金用）

6.5.2　ユーザーコールバックインターフェース（一般料金用）

6.5.3　ユーザーコールバックインターフェース（国庫金用）

6.5.1　ユーザーコールバックインターフェース（地方税・地公体料金用）

地方税・地公体料金用のユーザーコールバックについて説明します。

形式

int HMpnOcrBcdAnalysisUoc(
          const char            *in,
          const unsigned long   inLen,
          char                  *out,
          unsigned long         *outLen )

引数

引数には，通信サーバfor Billerが設定する引数と，ユーザーが設定できる引数があります。

通信サーバfor Billerが設定する引数

*in
電文情報の先頭アドレスを示すポインターです。参照用であるため，ユーザーコールバック内で変更しないでください。

inLen
in情報の長さです。参照用であるため，ユーザーコールバック内で変更しないでください。

*outLen
out領域の最大長です。1,024（単位：バイト）固定です。

ユーザーが設定できる引数

*out
ユーザーコールバックで取り出した値を設定する，領域の先頭アドレスを示すポインターです。この領域に，outLen以上の書き込みはできません。

*outLen
ユーザーコールバックでoutに設定した値の長さを指定します。

通信サーバfor Biller，およびユーザーが設定する引数にinとoutがあります。次にinおよびout領域の形式について説明します。

inおよびout領域の形式はTag，Length，およびValueから構成されています。これらの要素について次に示します。

Tag
設定する情報の識別子を指定します。設定する情報のchar属性4バイトとします。

Length
設定する情報の長さを指定します。char属性4バイトとします。

Value
設定する情報を指定します。char属性でLengthに指定したバイト数とします。

図6-3　inおよびout領域の形式（地方税・地公体料金の場合）

inの設定情報について，次に示します。

表6-5　inに設定する情報（地方税・地公体料金の場合）

設定する情報の種類 | in領域の構成要素
Tag | Length | Value
収納機関コード | 'H008' | 収納機関コード長（固定長のため，'0008'となります） | 収納機関コード
OCR情報 | 'B007' | OCR情報長（固定長のため'0083'となります） | OCR情報
バーコード情報 | 'B008' | バーコード情報長（可変長で，最大の場合，'0050'となります） | バーコード情報

また，outの設定情報について，次に示します。「納付区分」，「納付番号」および「確認番号」は必ず設定してください。

表6-6　outに設定する情報（地方税・地公体料金の場合）

設定する情報の種類 | out領域の構成要素
Tag | Length | Value
納付区分 | 'B010' | 納付区分長（可変長で，最大の場合，'0016'となります） | 納付区分（n属性）
納付番号 | 'B005' | 納付番号長（可変長で，最大の場合，'0020'となります） | 納付番号（an属性）
確認番号 | 'B006' | 確認番号長（可変長で，最大の場合，'0006'となります） | 確認番号（an属性）
地公体任意情報※ | 'B038' | 地公体任意情報長（可変長で，最大の場合，'0020'となります） | 地公体任意情報（ank属性）

（凡例）

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

ank：《英字》，《数字》，《カナ》，《記号》，《カナ記号》，およびSPACE

注

通信サーバfor Billerでは，outに設定する各情報をチェックしています。

注※

消込情報ファイルの変換コマンド（hmpnpayfile）でユーザーコールバックを呼び出す場合だけ設定してください。

戻り値

0：正常終了

0以外（任意の整数値）：エラーリターン

注

戻り値が0以外（任意の整数値）の場合，通信サーバfor Billerでは，処理を中断します。

6.5.2　ユーザーコールバックインターフェース（一般料金用）

一般料金用のユーザーコールバックについて説明します。

形式

int HMpnOcrBcdAnalysisUocGen(
           const char            *in,
           const unsigned long   inLen,
           char                  *out,
           unsigned long         *outLen )

引数

引数には，通信サーバfor Billerが設定する引数と，ユーザーが設定できる引数があります。

通信サーバfor Billerが設定する引数

*in
電文情報の先頭アドレスを示すポインターです。参照用であるため，ユーザーコールバック内で変更しないでください。

inLen
in情報の長さです。参照用であるため，ユーザーコールバック内で変更しないでください。

*outLen
out領域の最大長です。1,024（単位：バイト）固定です。

ユーザーが設定できる引数

*out
ユーザーコールバックで取り出した値を設定する，領域の先頭アドレスを示すポインターです。この領域に，outLen以上の書き込みはできません。

*outLen
ユーザーコールバックでoutに設定した値の長さを指定します。

通信サーバfor Biller，およびユーザーが設定する引数にinとoutがあります。次にinおよびout領域の形式について説明します。

inおよびout領域の形式はTag，Length，およびValueから構成されています。これらの要素について次に示します。

Tag
設定する情報の識別子を指定します。設定する情報のchar属性4バイトとします。

Length
設定する情報の長さを指定します。char属性4バイトとします。

Value
設定する情報を指定します。char属性でLengthに指定したバイト数とします。

図6-4　inおよびout領域の形式（一般料金の場合）

inの設定情報について，次に示します。

表6-7　inに設定する情報（一般料金の場合）

設定する情報の種類 | in領域の構成要素
Tag | Length | Value
収納機関コード | 'H008' | 収納機関コード長（固定長のため，'0008'となります） | 収納機関コード
OCR情報 | 'B007' | OCR情報長（固定長のため'0083'となります） | OCR情報
バーコード情報 | 'B008' | バーコード情報長（可変長で，最大の場合，'0050'となります） | バーコード情報

また，outの設定情報について，次に示します。

表6-8　outに設定する情報（一般料金の場合）

設定する情報の種類 | out領域の構成要素
Tag | Length | Value
お客様番号 | 'B005' | お客様番号長（可変長で，最大の場合，'0020'となります） | お客様番号（an属性）
確認番号 | 'B006' | 確認番号長（可変長で，最大の場合，'0006'となります） | 確認番号（an属性）

（凡例）

an：《英字》，《数字》，《記号》，およびSPACE

注

通信サーバfor Billerでは，outに設定する各情報をチェックしています。

戻り値

0：正常終了

0以外（任意の整数値）：エラーリターン

注

戻り値が0以外（任意の整数値）の場合，通信サーバfor Billerでは，処理を中断します。

6.5.3　ユーザーコールバックインターフェース（国庫金用）

国庫金用のユーザーコールバックについて説明します。

形式

int HMpnOcrBcdAnalysisUocTrs(
           const char            *in,
           const unsigned long   inLen,
           char                  *out,
           unsigned long         *outLen )

引数

引数には，通信サーバfor Billerが設定する引数と，ユーザーが設定できる引数があります。

通信サーバfor Billerが設定する引数

*in
電文情報の先頭アドレスを示すポインターです。参照用であるため，ユーザーコールバック内で変更しないでください。

inLen
in情報の長さです。参照用であるため，ユーザーコールバック内で変更しないでください。

*outLen
out領域の最大長です。1,024（単位：バイト）固定です。

ユーザーが設定できる引数

*out
ユーザーコールバックで取り出した値を設定する，領域の先頭アドレスを示すポインターです。この領域に，outLen以上の書き込みはできません。

*outLen
ユーザーコールバックでoutに設定した値の長さを指定します。

通信サーバfor Biller，およびユーザーが設定する引数にinとoutがあります。次にinおよびout領域の形式について説明します。

inおよびout領域の形式はTag，Length，およびValueから構成されています。これらの要素について次に示します。

Tag
設定する情報の識別子を指定します。設定する情報のchar属性4バイトとします。

Length
設定する情報の長さを指定します。char属性4バイトとします。

Value
設定する情報を指定します。char属性でLengthに指定したバイト数とします。

図6-5　inおよびout領域の形式（国庫金の場合）

inの設定情報について，次に示します。

表6-9　inに設定する情報（国庫金の場合）

設定する情報の種類 | in領域の構成要素
Tag | Length | Value
収納機関コード | 'H008' | 収納機関コード長（固定長のため，'0008'となります） | 収納機関コード
OCR情報 | 'B007' | OCR情報長（固定長のため'0083'となります） | OCR情報
バーコード情報 | 'B008' | バーコード情報長（可変長で，最大の場合，'0050'となります） | バーコード情報

また，outの設定情報について，次に示します。

表6-10　outに設定する情報（国庫金の場合）

設定する情報の種類 | out領域の構成要素
Tag | Length | Value
納付番号 | 'B005' | 納付番号長（可変長で，最大の場合，'0020'となります） | 納付番号（an属性）
確認番号 | 'B006' | 確認番号長（可変長で，最大の場合，'0006'となります） | 確認番号（an属性）
納付区分※ | 'B010' | 納付区分長（可変長で，最大の場合，'0016'となります） | 納付区分（n属性）

（凡例）

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

注

通信サーバfor Billerでは，outに設定する各情報をチェックしています。

注※

収納機関コードが国税庁（00200000）の場合に，納付区分を設定できます。

戻り値

0：正常終了

0以外（任意の整数値）：エラーリターン

注

戻り値が0以外（任意の整数値）の場合，通信サーバfor Billerでは，処理を中断します。

7.　通信サーバfor Billerのインターフェース

この章では，通信サーバfor Billerのインターフェースについて説明します。

＜この章の構成＞

7.1　業務系プロセスインターフェース

7.2　電文保証ポリシー

7.3　収納業務受付インターフェース

7.4　エラー検出時収納業務プログラム呼び出し機能

7.5　納付区分エラー変換機能

7.1　業務系プロセスインターフェース

業務系SPPの機能および業務系プロセスインターフェースについて説明します。

業務系プロセスインターフェースとは，通信サーバfor Billerの業務系SPPと収納業務プログラムとの間で，電文を送受信するためのインターフェースです。業務系プロセスインターフェースには，次に示す種類があります。国庫金とそれ以外とで機能差が大きいインターフェースについては，ここでは項を分けて説明しています。

表7-1　業務系プロセスインターフェースの種類

種類
用途
このマニュアルの記述個所

照会SPP用インターフェース
照会SPPと収納業務プログラムの間で，照会処理に必要な電文を送受信する。
7.1.1

消込SPP用インターフェース
消込SPPと収納業務プログラムとの間で，消込処理に必要な電文を送受信する。

地方税・地公体料金，一般料金の場合

7.1.2

国庫金の場合

7.1.3

取消SPP用インターフェース
取消SPPと収納業務プログラムとの間で，取消処理に必要な電文を送受信する。
7.1.4

再送確認SPP用インターフェース
再送確認SPPと収納業務プログラムとの間で，再送確認処理に必要な電文を送受信する。
再送確認とは，要求された収納情報が消込済みかどうかを判定し，消込済みでない場合に，消込情報をDBに書き込む処理を指す。

地方税・地公体料金，一般料金の場合

7.1.5

国庫金の場合

7.1.6

収納業務プログラムへの電文の送信は，通信サーバシステム定義で指定したSPPを呼び出して行われます。呼び出されるSPPの定義については，「表4-3　収納機関単位で使用するSPP用定義（収納業務プログラム）」を参照してください。

＜この節の構成＞

7.1.1　照会SPP用インターフェース

7.1.2　消込SPP用インターフェース（地方税・地公体料金，一般料金の場合）

7.1.3　消込SPP用インターフェース（国庫金の場合）

7.1.4　取消SPP用インターフェース

7.1.5　再送確認SPP用インターフェース（地方税・地公体料金，一般料金の場合）

7.1.6　再送確認SPP用インターフェース（国庫金の場合）

7.1.7　省略形式の電文

7.1.1　照会SPP用インターフェース

ここでは，照会SPP用インターフェースの機能および通信形式について説明します。

＜この項の構成＞

(1)　照会SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　照会SPPの機能

照会SPPは，次の順序で照会依頼電文を処理します。

MPNセンタから照会依頼電文を受信する

収納業務プログラムに応答電文の作成を要求する

収納業務プログラムで作成された応答電文を受信する

受信した応答電文をMPNセンタに返送する

照会依頼電文の処理の流れを次に示します。

図7-1　照会依頼電文の処理の流れ

注※

通信サーバfor BillerがMPNセンタに送信する照会応答電文は次のとおりです。

リターンコードにALL0を指定した場合

収納業務プログラムが作成した照会応答電文を送信します。

リターンコードにALL0以外を指定した場合

照会エラー応答電文を作成し，送信します。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(
 struct  DCRPC_BINDING_TBL  *direction,
        char    *group,
        char    *service,
        char    *in,
        DCULONG *in_len,
        char    *out,
        DCULONG *out_len,
        DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-2　通信サーバfor Billerが設定する引数（照会SPP用インターフェース）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-2　通信サーバが送信する電文の形式（照会SPP用インターフェース）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。リターンコードにはALL0が設定されます。制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。
一般料金の場合，または国庫金で収納機関コードが国税庁（00200000）以外の場合，「納付区分」にはNULLが設定されます。

MPN電文
MPNセンタから受信した電文です。

(b)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-3　収納業務プログラムが設定する引数（照会SPP用インターフェース）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-3　通信サーバが受信する電文の形式（照会SPP用インターフェース）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。
なお，通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。また，「お客様番号」，「確認番号」および「納付区分」の内容も変更できません。

MPN電文
MPNセンタへ送信する電文を設定してください。
なお，エラー時には，省略形式の電文を返すこともできます。ただし，正常応答電文（1120）は省略できません。
省略形式の電文については，「7.1.7　省略形式の電文」を参照してください。

7.1.2　消込SPP用インターフェース（地方税・地公体料金，一般料金の場合）

ここでは，地方税・地公体料金，一般料金の場合の消込SPP用インターフェースの機能および通信形式について説明します。

＜この項の構成＞

(1)　消込SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　消込SPPの機能

消込SPPは，次の順序で消込依頼電文を処理します。

MPNセンタから消込依頼電文を受信する

応答電文を作成する

作成した応答電文をMPNセンタに返送する※

収納業務プログラムに消込依頼電文を送信する

収納業務プログラムから結果応答を受信する

注※

消込応答電文は，必ず正常応答電文として返送します。

消込依頼電文の処理の流れを次に示します。

図7-4　消込依頼電文の処理の流れ

注※1

更新または設定される項目を次に示します。

表7-4　DBに更新または設定される項目（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

項目名 | 内容説明
消込カウンタ | 該当する収納情報の消込回数です。DBで更新されます。
消込情報レコード | 消込依頼電文の「お客様番号（納付番号）」，「確認番号」，「納付区分」，「仕向センタコード」，「仕向処理年月日」および「仕向処理通番」によって特定し，DBへ設定されます。なお，「確認番号」は各収納情報の識別番号または請求番号で「確認番号」を決定しています。また，該当する収納情報が消込済みであっても，履歴情報として消込情報が設定されます。

注※2

反映される項目を次に示します。

表7-5　DBで反映される項目（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

項目名 | 内容説明
結果応答の制御ヘッダー部のリターンコード | DBで，該当する消込情報の項目として反映されます。また，消込情報レコードが複数ある場合は，該当するすべてのレコードに反映されます。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(  struct  DCRPC_BINDING_TBL  *direction,
       char     *group,
       char     *service,
       char     *in,
       DCULONG  *in_len,
       char     *out,
       DCULONG  *out_len,
       DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-6　通信サーバfor Billerが設定する引数（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-5　通信サーバが送信する電文の形式（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。リターンコードにはALL0が設定されます。仮消込情報として通信サーバfor Billerが設定するリターンコードについては，「(b)　通信サーバfor Billerが設定するリターンコード」を参照してください。また，制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。
また，一般料金の場合，「納付区分」にはNULLが設定されます。

MPN電文
MPNセンタから受信した電文です。

(b)　通信サーバfor Billerが設定するリターンコード

消込処理を正常に実行できなかった場合に，仮消込情報として通信サーバfor Billerが設定するリターンコードを次に示します。

表7-7　通信サーバfor Billerが設定するリターンコード（地方税・地公体料金，一般料金の場合）

リターンコード
説明

HMPN9001
収納情報が複数ある場合，設定します。

HMPNA002
設定する場合を次に示します。

金融機関コード，または店舗コードがDBの対象金融機関情報格納用テーブルに登録されているものと不一致の場合※1

税目・料金番号※2，金融機関コード，店舗コード，およびチャネル区分は一致しているが，適用年月日は範囲外の場合※1

HMPNA003
MPN電文のデータ部のお客様番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得したお客様番号が不一致の場合，設定します。

HMPNA004
MPN電文のデータ部の確認番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した確認番号が不一致の場合，設定します。

HMPNA010
税目・料金番号※2，金融機関コード，および店舗コードは一致しているが，チャネル区分が不一致の場合※1，設定します。

HMPNA013
金融機関コード，および店舗コードは一致しているが，税目・料金番号※2は不一致の場合，設定します。※1

HMPNA101
入力区分が情報リンク以外で，収納情報がない場合，設定します。

注※1

対象金融機関チェックでエラーの場合です。対象金融機関チェックについては，「1.6.3(1)　対象金融機関チェック」を参照してください。

注※2

税目・料金番号は，地方税・地公体料金の場合だけ設定しています。

(c)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-8　収納業務プログラムが設定する引数（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-6　通信サーバが受信する電文の形式（消込SPP用インターフェース：地方税・地公体料金，一般料金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。「お客様番号」，「確認番号」および「納付区分」の内容についても変更できません。また，リターンコードは消込結果として，DBに反映されます。

7.1.3　消込SPP用インターフェース（国庫金の場合）

ここでは，国庫金の消込SPP用インターフェースの機能および通信形式について説明します。

＜この項の構成＞

(1)　消込SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　消込SPPの機能

消込SPPは，次の順序で国庫金消込依頼電文を処理します。

MPNセンタから国庫金消込依頼電文を受信する

収納業務プログラムに国庫金消込依頼電文を送信する

収納業務プログラムで作成された応答電文を受信する※

消込可能かどうかを判定する

受信した応答電文をMPNセンタに返送する

注※

収納業務プログラムから応答送信抑止要求があった場合は，メッセージKDMQBS106-IおよびKDMQBS405-Iを出力して電文を破棄します。

国庫金消込依頼電文の処理の流れを次に示します。

図7-7　国庫金消込依頼電文の処理の流れ

注※

更新または設定される項目を次に示します。

表7-9　DBに更新または設定される項目（消込SPP用インターフェース：国庫金の場合）

項目名 | 内容説明
消込カウンタ | 該当する収納情報の消込回数です。DBで更新されます。
消込情報レコード | 国庫金消込依頼電文の「納付番号」，「確認番号」，「納付区分」，「仕向センタコード」，「仕向処理年月日」および「仕向処理通番」によって特定し，DBへ設定されます。また，該当する収納情報が消込済みであっても，履歴情報として消込情報が設定されます。
結果応答の制御ヘッダー部のリターンコード | DBで，該当する消込情報の項目として反映されます。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(  struct  DCRPC_BINDING_TBL  *direction,
       char     *group,
       char     *service,
       char     *in,
       DCULONG  *in_len,
       char     *out,
       DCULONG  *out_len,
       DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-10　通信サーバfor Billerが設定する引数（消込SPP用インターフェース：国庫金の場合）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-8　通信サーバが送信する電文の形式（消込SPP用インターフェース：国庫金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。正常応答の場合，リターンコードにはALL0が設定されます。通信サーバfor Billerが設定するリターンコードについては，「(b)　通信サーバfor Billerが設定するリターンコード」を参照してください。また，制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。

MPN電文
MPNセンタから受信した電文です。

(b)　通信サーバfor Billerが設定するリターンコード

消込処理を正常に実行できなかった場合に，通信サーバfor Billerが設定するリターンコードを次に示します。

表7-11　通信サーバfor Billerが設定するリターンコード（国庫金の場合）

リターンコード
説明

HMPNA002
設定する場合を次に示します。

歳入代理店金融機関コード，または店舗コードがDBの国庫金対象金融機関情報格納用テーブルに登録されているものと不一致の場合※1

歳入代理店金融機関コード，店舗コード，およびチャネル区分は一致しているが，適用年月日は範囲外の場合※1

HMPNA003
MPN電文のデータ部の納付番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した納付番号が不一致の場合，設定します。

HMPNA004
MPN電文のデータ部の確認番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した確認番号が不一致の場合，設定します。

HMPNA010
歳入代理店金融機関コード，および店舗コードは一致しているが，チャネル区分が不一致の場合※1，設定します。

HMPNA013
歳入代理店金融機関コード，および店舗コードは一致しているが，納付区分※2が不一致の場合，設定します。※1

HMPNA101
入力区分が情報リンク以外で，収納情報がない場合，設定します。

注※1

対象金融機関チェックでエラーの場合です。対象金融機関チェックについては，「1.6.3(1)　対象金融機関チェック」を参照してください。

注※2

納付区分は，国庫金では収納機関コードが国税庁（00200000）の場合だけ設定しています。

(c)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-12　収納業務プログラムが設定する引数（消込SPP用インターフェース：国庫金の場合）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-9　通信サーバが受信する電文の形式（消込SPP用インターフェース：国庫金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。「納付番号」，「確認番号」および「納付区分」の内容についても変更できません。

MPN電文
MPNセンタへ送信する電文を設定してください。
なお，エラー時には，省略形式の電文を返すこともできます。
省略形式の電文については，「7.1.7　省略形式の電文」を参照してください。

7.1.4　取消SPP用インターフェース

ここでは，取消SPPの機能および通信形式について説明します。

なお，国庫金の場合は，取消依頼電文を国庫金取消依頼電文，国庫金の取消応答電文を国庫金取消応答電文と読み替えてください。

＜この項の構成＞

(1)　取消SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　取消SPPの機能

取消SPPは，次の順序で取消依頼電文を処理します。

MPNセンタから取消依頼電文を受信する

収納業務プログラムに応答電文の作成を要求する

収納業務プログラムで作成された応答電文を受信する

受信した応答電文をMPNセンタに返送する

取消依頼電文の処理の流れを次に示します。

図7-10　取消依頼電文の処理の流れ

注※1

通信サーバfor BillerがMPNセンタに送信する取消応答電文は次のとおりです。また，取消応答電文の電文種別コードを参照した結果によって消込情報を取り消すかどうかが決定します。

リターンコードにALL0を設定した場合

収納業務プログラムが作成した取消応答電文の電文種別コードを参照した結果，正常応答のとき，取消応答電文をMPNセンタに送信し，該当する消込情報を取り消します。また，電文種別コードを参照した結果，正常応答以外のときは，収納業務プログラムが作成した取消応答電文をMPNセンタに送信しますが，該当する消込情報を取り消しません。

消込情報の取消は，収納情報の取消カウンタの更新および消込情報の取消フラグの更新によって行われます。

リターンコードにALL0以外を設定した場合

通信サーバfor Billerが取消エラー応答電文を作成し，MPNセンタに送信しますが，該当する消込情報は取り消しません。

注※2

設定または更新される項目を次に示します。

表7-13　DBで設定または更新される項目（取消SPP用インターフェース）

項目名 | 内容説明
取消フラグ | DBで，該当する消込情報の項目として設定されます。なお，該当する消込情報は，「お客様番号」，「確認番号」，「納付区分」，「仕向センタコード」，「仕向処理年月日」および「仕向処理通番」によって特定されます。
取消カウンタ | 該当する収納情報の取消に対する履歴情報の項目です。DBで更新されます。また，消込情報レコードが複数ある場合は，該当するすべてのレコードに反映されます。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(
 struct  DCRPC_BINDING_TBL  *direction,
        char    *group,
        char    *service,
        char    *in,
        DCULONG *in_len,
        char    *out,
        DCULONG *out_len,
        DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-14　通信サーバfor Billerが設定する引数（取消SPP用インターフェース）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-11　通信サーバが送信する電文の形式（取消SPP用インターフェース）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。リターンコードにはALL0が設定されます。制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。
また，一般料金の場合，「納付区分」にはNULLが設定されます。

MPN電文
MPNセンタから受信した電文です。

(b)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-15　収納業務プログラムが設定する引数（取消SPP用インターフェース）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-12　通信サーバが受信する電文の形式（取消SPP用インターフェース）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。
なお，通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。また，「お客様番号」，「確認番号」および「納付区分」の内容も変更できません。

MPN電文
MPNセンタに送信する電文を設定してください。
なお，正常時またはエラー時には，省略形式の電文を返すこともできます。
省略形式の電文については，「7.1.7　省略形式の電文」を参照してください。

7.1.5　再送確認SPP用インターフェース（地方税・地公体料金，一般料金の場合）

ここでは，地方税・地公体料金，一般料金の場合の再送確認用SPPインターフェースの機能および通信形式について説明します。

＜この項の構成＞

(1)　再送確認SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　再送確認SPPの機能

再送確認SPPは，次の順序で再送確認通知電文を処理します。

MPNセンタから再送確認通知電文を受信する

受信した電文中の情報が消込できるかどうかを判定する

応答電文を作成する

作成した応答電文をMPNセンタに返送する※

収納業務プログラムに再送確認通知電文を送信する

収納業務プログラムから返送された結果応答を受信する

注※

再送確認応答電文は，必ず正常応答電文として返送します。

再送確認通知電文の処理の流れを次に示します。

図7-13　再送確認通知電文の処理の流れ（地方税・地公体料金，一般料金の場合）

注※1

消込済みかどうかは，DBの次の項目で判定されます。すべての項目が該当する場合は，消込済みです。

該当する消込情報レコードがある

消込情報の取消フラグがOFFである（取消なし）

注※2

更新または設定される項目を次に示します。

表7-16　DBで更新または設定される項目（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

項目名 | 内容説明
消込カウンタ | 該当する収納情報の消込回数です。DBで更新されます。
消込情報レコード | 消込依頼電文の「お客様番号」，「確認番号」，「納付区分」，「仕向センタコード」，「仕向処理年月日」および「仕向処理通番」によって特定し，DBへ設定されます。なお，「確認番号」は各収納情報の識別番号または請求番号で「確認番号」を決定しています。

注※3

反映される項目を次に示します。

表7-17　DBで反映される項目（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

項目名 | 内容説明
結果応答の制御ヘッダー部のリターンコード | DBで，該当する消込情報の項目として反映されます。また，消込情報レコードが複数ある場合は，該当するすべてのレコードに反映されます。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(
 struct  DCRPC_BINDING_TBL  *direction,
        char    *group,
        char    *service,
        char    *in,
        DCULONG *in_len,
        char    *out,
        DCULONG *out_len,
        DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-18　通信サーバfor Billerが設定する引数（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-14　通信サーバが送信する電文の形式（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。リターンコードにはALL0が設定されます。仮消込情報として通信サーバfor Billerが設定するリターンコードについては，「(b)　通信サーバfor Billerが設定するリターンコード」を参照してください。また，制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。
また，一般料金の場合，「納付区分」にはNULLが設定されます。

MPN電文
MPNセンタから受信した電文です。

(b)　通信サーバfor Billerが設定するリターンコード

消込処理を正常に実行できなかった場合に，仮消込情報として通信サーバfor Billerが設定するリターンコードを次に示します。

表7-19　通信サーバfor Billerが設定するリターンコード（地方税・地公体料金，一般料金の場合）

リターンコード
説明

HMPN9001
収納情報が複数ある場合，設定します。

HMPNA002
設定する場合を次に示します。

金融機関コード，または店舗コードがDBの対象金融機関情報格納用テーブルに登録されているものと不一致の場合※1

税目・料金番号※2，金融機関コード，店舗コード，およびチャネル区分は一致しているが，適用年月日は範囲外の場合※1

HMPNA003
MPN電文のデータ部のお客様番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得したお客様番号が不一致の場合，設定します。

HMPNA004
MPN電文のデータ部の確認番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した確認番号が不一致の場合，設定します。

HMPNA010
税目・料金番号※2，金融機関コード，および店舗コードは一致しているが，チャネル区分が不一致の場合※1，設定します。

HMPNA013
金融機関コード，および店舗コードは一致しているが，税目・料金番号※2は不一致の場合，設定します。※1

HMPNA101
入力区分が情報リンク以外で，収納情報がない場合，設定します。

注※1

対象金融機関チェックでエラーの場合です。対象金融機関チェックについては，「1.6.3(1)　対象金融機関チェック」を参照してください。

注※2

税目・料金番号は，地方税・地公体料金の場合だけ設定しています。

(c)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-20　収納業務プログラムが設定する引数（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-15　通信サーバが受信する電文の形式（再送確認SPP用インターフェース：地方税・地公体料金，一般料金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。また，「お客様番号」，「確認番号」および「納付区分」の内容も変更できません。
なお，リターンコードは消込結果として，DBに登録されます。

7.1.6　再送確認SPP用インターフェース（国庫金の場合）

ここでは，国庫金の再送確認SPP用インターフェースの機能および通信形式について説明します。

＜この項の構成＞

(1)　再送確認SPPの機能

(2)　RPC通信形式

(3)　引数

(1)　再送確認SPPの機能

再送確認SPPは，次の順序で国庫金再送確認通知電文を処理します。

MPNセンタから国庫金再送確認通知電文を受信する

収納業務プログラムに国庫金再送確認通知電文を送信する

収納業務プログラムで作成された応答電文を受信する※

消込可能かどうかを判定する

受信した応答電文をMPNセンタに返送する

注※

収納業務プログラムから応答送信抑止要求があった場合は，メッセージKDMQBS106-IおよびKDMQBS405-Iを出力して電文を破棄します。

国庫金再送確認通知電文の処理の流れを次に示します。

図7-16　国庫金再送確認通知電文の処理の流れ

注※

更新または設定される項目を次に示します。

表7-21　DBで更新または設定される項目（再送確認SPP用インターフェース：国庫金の場合）

項目名 | 内容説明
消込カウンタ | 該当する収納情報の消込回数です。DBで更新されます。
消込情報レコード | 国庫金再送確認通知電文の「納付番号」，「確認番号」，「納付区分」，「仕向センタコード」，「仕向処理年月日」および「仕向処理通番」によって特定し，DBへ設定されます。また，該当する収納情報が消込済みであっても，履歴情報として消込情報が設定されます。
結果応答の制御ヘッダー部のリターンコード | DBで，該当する消込情報の項目として反映されます。

(2)　RPC通信形式

通信形式を次に示します。

int dc_rpc_call_to(
 struct  DCRPC_BINDING_TBL  *direction,
        char    *group,
        char    *service,
        char    *in,
        DCULONG *in_len,
        char    *out,
        DCULONG *out_len,
        DCLONG  flags )

(3)　引数

引数には，通信サーバfor Billerが設定する引数と，収納業務プログラムが設定する引数があります。

(a)　通信サーバfor Billerが設定する引数

通信サーバfor Billerが設定する引数を次に示します。

表7-22　通信サーバfor Billerが設定する引数（再送確認SPP用インターフェース：国庫金の場合）

引数 | 設定値
direction | サービスの要求先を特定する検索キーを格納するDCRPC_BINDING_TBL構造体のアドレス
group | 通信サーバシステム定義で指定したサービスグループ名
service | 通信サーバシステム定義で指定したサービス名
in | 下図の形式で電文を設定
in_len | inの形式の電文長
out_len | out領域の電文長（10,257バイトを設定）
flags | DCNOFLAGS

図7-17　通信サーバが送信する電文の形式（再送確認SPP用インターフェース：国庫金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。正常応答の場合，リターンコードにはALL0が設定されます。通信サーバfor Billerが設定するリターンコードについては，「(b)　通信サーバfor Billerが設定するリターンコード」を参照してください。また，制御ヘッダー部の形式については，「付録B　制御ヘッダー部のフォーマット」を参照してください。

MPN電文
MPNセンタから受信した電文です。

(b)　通信サーバfor Billerが設定するリターンコード

消込処理を正常に実行できなかった場合に，通信サーバfor Billerが設定するリターンコードを次に示します。

表7-23　通信サーバfor Billerが設定するリターンコード（国庫金の場合）

リターンコード
説明

HMPNA002
設定する場合を次に示します。

歳入代理店金融機関コード，または店舗コードがDBの国庫金対象金融機関情報格納用テーブルに登録されているものと不一致の場合※1

歳入代理店金融機関コード，店舗コード，およびチャネル区分は一致しているが，適用年月日は範囲外の場合※1

HMPNA003
MPN電文のデータ部の納付番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した納付番号が不一致の場合，設定します。

HMPNA004
MPN電文のデータ部の確認番号と，データ解析用のユーザーコールバックでOCR情報およびバーコード情報から取得した確認番号が不一致の場合，設定します。

HMPNA010
歳入代理店金融機関コード，および店舗コードは一致しているが，チャネル区分が不一致の場合※1，設定します。

HMPNA013
歳入代理店金融機関コード，および店舗コードは一致しているが，納付区分※2は不一致の場合，設定します。※1

HMPNA101
入力区分が情報リンク以外で，収納情報がない場合，設定します。

注※1

対象金融機関チェックでエラーの場合です。対象金融機関チェックについては，「1.6.3(1)　対象金融機関チェック」を参照してください。

注※2

納付区分は，国庫金では収納機関コードが国税庁（00200000）の場合だけ設定しています。

(c)　収納業務プログラムが設定する引数

収納業務プログラムが設定する引数を次に示します。

表7-24　収納業務プログラムが設定する引数（再送確認SPP用インターフェース：国庫金の場合）

引数 | 設定値
out | 下図の形式で電文を設定（通信サーバfor Billerの引数out_lenで設定した電文長（10,257バイト）以上の情報は設定できません）
out_len | outの形式の電文長

図7-18　通信サーバが受信する電文の形式（再送確認SPP用インターフェース：国庫金の場合）

制御ヘッダー部
通信サーバfor Billerと収納業務プログラムのインターフェースヘッダーです。通信サーバfor Billerでは，リターンコードおよび電文IDを内部トレース情報として取得します。そのため，収納業務プログラムでは，inで渡された電文IDの内容を変更しないでください。また，「納付番号」，「確認番号」および「納付区分」の内容も変更できません。

MPN電文
MPNセンタへ送信する電文を設定してください。
なお，エラー時には，省略形式の電文を返すこともできます。
省略形式の電文については，「7.1.7　省略形式の電文」を参照してください。

7.1.7　省略形式の電文

収納業務プログラムでは，照会エラー応答，消込エラー応答（国庫金の場合だけ），取消応答，取消エラー応答，または再送確認通知エラー応答（国庫金の場合だけ）で，省略形式の電文を返すこともできます。

電文を省略する場合，収納業務プログラムでは次の形式で設定してください。

図7-19　省略形の応答電文の形式

省略電文に設定する電文種別コードとレスポンスコードを次に示します。

電文種別コード
次の電文種別コードを設定します。

電文種別コード | 電文の種類
1130 | 照会エラー応答電文
2230 | 国庫金消込エラー応答電文
1321 | 取消応答電文
2320 | 国庫金取消応答電文
1331 | 取消エラー応答電文
2330 | 国庫金取消エラー応答電文
2730 | 国庫金再送確認通知エラー応答電文

レスポンスコード
MPNセンタへ送信するレスポンスコードを設定します。

7.2　電文保証ポリシー

ここでは，通信サーバfor Billerの電文保証の概要，保証する電文項目，および通信サーバfor Billerが設定するレスポンスコードについて説明します。

＜この節の構成＞

7.2.1　電文保証の概要

7.2.2　通信サーバfor Billerが保証する電文項目

7.2.3　レスポンスコード

7.2.1　電文保証の概要

通信サーバfor Billerは，MPNセンタから送信された電文を保証します。これを電文保証と呼びます。収納業務プログラムから送信された応答電文の中に不正な電文が含まれていた場合，通信サーバfor Billerは，MPNセンタから送信された依頼電文の内容を応答電文に設定することで，電文を保証します。通信サーバfor Billerが保証する電文には，次の種類があります。

照会依頼電文

取消依頼電文

国庫金取消依頼電文

国庫金消込依頼電文

国庫金再送確認通知電文

通信サーバfor Billerによる電文保証の流れを次に示します。

図7-20　通信サーバfor Billerによる電文保証の流れ

注※

通信サーバfor Billerが不正な電文項目を発見した場合，通信サーバfor Billerが保証する前の電文は，不正電文情報としてDBの障害情報格納用テーブルに登録されます。障害情報格納用テーブルについては，「5.1　DBに作成するテーブルの種類」または「付録A.8　不正電文情報を格納するためのユーザー用RDエリアの算出方法」を参照してください。

このように電文保証では，収納業務プログラムが正常応答としていても，通信サーバfor Billerが不正な電文項目を発見した場合は，MPNセンタにエラー応答をします。通信サーバfor Billerがどの電文項目を保証するかについては，「7.2.2　通信サーバfor Billerが保証する電文項目」を参照してください。

電文保証のタイミングを次に示します。

図7-21　電文保証のタイミング（照会依頼電文の場合）

7.2.2　通信サーバfor Billerが保証する電文項目

ここでは，通信サーバfor Billerが保証する電文項目について説明します。

＜この項の構成＞

(1)　ヘッダー部

(2)　データ部

(1)　ヘッダー部

通信サーバfor Billerは，まずヘッダー部を保証します。通信サーバfor Billerが保証するヘッダー部の電文項目について，次に示します。

表7-25　通信サーバfor Billerが保証するヘッダー部の電文項目

項目名 | 電文属性 | 保証の有無
電文種別コード | n4 | －
仕向トランザクション番号 | n5 | ○
被仕向トランザクション番号 | n5 | ○
仕向センタコード | an10 | ○
被仕向センタコード | an10 | ○
金融機関コード | n8 | ○
店舗コード | n6 | ○
収納機関コード | an8 | ○
仕向処理年月日 | n8 | ○
仕向処理時刻 | n6 | ○
仕向処理通番 | n8 | ○
MPN処理年月日 | n8 | ○
MPN処理時刻 | n6 | ○
MPN処理通番 | n10 | ○
精査金額 | n11 | ○
オリジナル電文種別コード | n4 | ○
オリジナルレスポンスコード | an4 | ○
予備 | n4 | ○
レスポンスコード | an4 | －
歳入代理店金融機関コード | n8 | ○
予備 | n19 | ○
電文長 | n4 | －

（凡例）

○：通信サーバfor Billerが保証する

－：通信サーバfor Billerが保証しない

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

nxまたはanx：固定長桁数（例：「n4」は4桁の《数字》を示す）

(2)　データ部

通信サーバfor Billerはヘッダー部の電文種別コードから，データ部を保証します。通信サーバfor Billerが保証するデータ部の電文項目について，地方税・地公体料金，一般料金と国庫金で，表を分けて示します。

表7-26　通信サーバfor Billerが保証するデータ部の電文項目（地方税・地公体料金，一般料金の場合）

bit | 項目名 | 電文属性 | 保証の有無
照会応答電文 | 取消応答電文
1120 | 1130 | 1321 | 1331
2 | チャネル区分 | n2 | ○ | ○ | ○ | ○
3 | 納付金区分 | n2 | ○ | ○ | ○ | ○
4 | 入力区分 | n2 | ○ | ○ | ○ | ○
5 | お客様番号 | n2/an..20 | － | ○ | ○ | ○
6 | 確認番号 | n1/an..6 | － | ○ | ○ | ○
7 | OCR情報 | an83 | ○ | ○ | － | －
8 | バーコード情報 | n2/an..50 | ○ | ○ | － | －
10 | 納付区分 | n2/an..16 | ○ | ○ | ○ | ○
14 | 入金日 | n8 | － | － | ○ | ○
16 | 取消情報1 | 仕向センタコード | an10 | － | － | ○ | ○
仕向処理年月日 | n8 | － | － | ○ | ○
仕向処理通番 | n8 | － | － | ○ | ○
消込区分 | n1 | － | － | ○ | ○
請求番号 | an20 | － | － | ○ | ○
請求金額 | n11 | － | － | ○ | ○
請求金額元金 | n11 | － | － | ○ | ○
延滞金 | n8 | － | － | ○ | ○
消費税額 | n10 | － | － | ○ | ○
17 | 他店券金額 | n11 | － | － | ○ | ○
20 | パスワード | n2/an..20 | － | ○ | － | －
23 | 表示件数 | n2 | ○ | ○ | － | －
24 | 支払方法 | n1 | － | － | ○ | ○
25 | 印紙税額 | n3 | － | － | ○ | ○
26 | 金融機関任意情報 | n2/an..20 | ○ | ○ | ○ | ○
31 | 収納金額 | n11 | － | － | ○ | ○
32 | 収納日 | n8 | ○ | ○ | － | －
33 | 照会時刻 | n6 | ○ | ○ | － | －
39 | 手数料負担区分 | n1 | － | － | ○ | ○
40 | 取消情報2 | 仕向センタコード | an10 | － | － | ○ | ○
仕向処理年月日 | n8 | － | － | ○ | ○
仕向処理通番 | n8 | － | － | ○ | ○
消込区分 | n1 | － | － | ○ | ○
識別番号 | an20 | － | － | ○ | ○
納付合計金額 | n11 | － | － | ○ | ○
納付額 | n11 | － | － | ○ | ○
延滞金 | n8 | － | － | ○ | ○
予備 | n12 | － | － | ○ | ○

（凡例）

○：通信サーバfor Billerが保証する

－：通信サーバfor Billerが保証しない

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

nx，またはanx：固定長桁数（例：「n4」は4桁の《数字》を示す）

an..x：可変長桁数（例：「an..50」は最大50桁の《英字》，《数字》，《記号》，およびSPACEを示す）

表7-27　通信サーバfor Billerが保証するデータ部の電文項目（国庫金の場合）

bit | 項目名 | 電文属性 | 保証の有無
照会応答電文 | 国庫金取消応答電文 | 国庫金消込応答電文 | 国庫金再送確認応答電文
1120 | 1130 | 2320 | 2330 | 2220 | 2230 | 2720 | 2730
2 | チャネル区分 | n2 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
3 | 納付金区分 | n2 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
4 | 入力区分 | n2 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
5 | 納付番号 | n2/an..20 | － | － | ○ | ○ | ○ | ○ | ○ | ○
6 | 確認番号 | n1/an..6 | － | － | ○ | ○ | ○ | ○ | ○ | ○
7 | OCR情報 | an83 | ○ | ○ | － | － | ○ | ○ | ○ | ○
8 | バーコード情報 | n2/n..50 | ○ | ○ | － | － | ○ | ○ | ○ | ○
9 | 支払形態 | n1 | － | － | － | － | ○ | ○ | ○ | ○
10 | 納付区分 | n2/n..16 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
12 | 照会有無 | n1 | － | － | － | － | ○ | ○ | ○ | ○
17 | 他店券金額 | n11 | － | － | ○ | ○ | ○ | ○ | ○ | ○
20 | パスワード | n2/an..20 | － | ○ | － | － | － | － | － | －
23 | 表示件数 | n2 | ○ | ○ | － | － | － | － | － | －
24 | 支払方法 | n1 | － | － | ○ | ○ | ○ | ○ | ○ | ○
26 | 金融機関任意情報 | n2/an..20 | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○
31 | 収納金額 | n11 | － | － | ○ | ○ | ○ | ○ | ○ | ○
32 | 収納日 | n8 | ○ | ○ | － | － | ○ | ○ | ○ | ○
33 | 照会時刻 | n6 | ○ | ○ | － | － | ○ | ○ | ○ | ○
34 | 領収区分 | n1 | － | － | － | － | ○ | ○ | ○ | ○
43 | 納付情報－国庫金 | 支払内容（カナ） | ank24 | － | － | － | － | ○ | ○ | ○ | ○
支払内容（漢字） | K12 | － | － | － | － | ○ | ○ | ○ | ○
国庫金画面区分 | n1 | － | － | － | － | ○ | ○ | ○ | ○
支払金額 | n11 | － | － | － | － | ○ | ○ | ○ | ○
内元本 | n11 | － | － | － | － | ○ | ○ | ○ | ○
内延滞金表示区分 | n1 | － | － | － | － | ○ | ○ | ○ | ○
内延滞金 | n11 | － | － | － | － | ○ | ○ | ○ | ○
内手数料表示区分 | n1 | － | － | － | － | ○ | ○ | ○ | ○
内手数料 | n11 | － | － | － | － | ○ | ○ | ○ | ○
45 | 取消情報3 | 仕向センタコード | an10 | － | － | ○ | ○ | － | － | － | －
仕向処理年月日 | n8 | － | － | ○ | ○ | － | － | － | －
仕向処理通版 | n8 | － | － | ○ | ○ | － | － | － | －
消込区分 | n1 | － | － | ○ | ○ | － | － | － | －
納付番号 | an20 | － | － | ○ | ○ | － | － | － | －
払込金額 | n11 | － | － | ○ | ○ | － | － | － | －
内元本 | n11 | － | － | ○ | ○ | － | － | － | －
内延滞金 | n11 | － | － | ○ | ○ | － | － | － | －
内手数料 | n11 | － | － | ○ | ○ | － | － | － | －

（凡例）

○：通信サーバfor Billerが保証する

－：通信サーバfor Billerが保証しない

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

ank：《英字》，《数字》，《カナ》，《記号》，《カナ記号》，およびSPACE

K：《全角文字》

nx，anx，ankx，またはKx：固定長けた数（例：「n4」は4桁の《数字》を示す）

n..x，またはan..x：可変長けた数（例：「n..50」は最大50桁の《数字》を示す）

7.2.3　レスポンスコード

通信サーバfor Billerは，MPNセンタに応答電文を送信する際に，次のレスポンスコードを設定します。

＜この項の構成＞

(1)　レスポンスコード（地方税・地公体料金，一般料金の場合）

(2)　レスポンスコード（国庫金の場合）

(1)　レスポンスコード（地方税・地公体料金，一般料金の場合）

地方税・地公体料金，一般料金の場合のレスポンスコードを次に示します。

表7-28　通信サーバfor Billerが設定するレスポンスコード一覧（地方税・地公体料金，一般料金の場合）

レスポンスコード
説明
照会応答電文
消込依頼電文
取消応答電文
再送確認通知電文
カウンタ応答電文

1120
1130※1
1211
1321
1331※1
1720
1620
1630

0000
処理が正常の場合に設定します。
－
－
○
－
－
○
○
－

A001
設定する場合を次に示します。

MPNセンタが未開局の場合

業務系SPPが未起動の場合

－
○
－
－
○
－
－
－

A002
設定する場合を次に示します。

該当する金融機関がDBに存在しない場合

該当する金融機関がDBに存在するが，契約前または契約期限が切れている場合

－
○
－
－
○
－
－
－

A010
該当する金融機関はDBに存在するが，対応していないチャネルから取引を行おうとしている場合に設定します。
－
○
－
－
－
－
－
－

A013
該当する金融機関はDBに存在するが，対応する税目・料金番号※2が見つからない場合に設定します。
－
○
－
－
－
－
－
－

A301
チャネル区分が窓口以外の場合に設定します。
－
－
－
－
○
－
－
－

A601
カウンタ年月日が不正の場合に設定します。
－
－
－
－
－
－
－
○

9001
設定する場合を次に示します。

収納業務プログラムの呼び出しに失敗した場合

制御ヘッダー部が不正である場合※3

応答電文が不正である場合※3

内部エラーが発生した場合

該当する金融機関はDBに存在するが，対応していないチャネルから取引を行おうとしている場合※4

該当する金融機関はDBに存在するが，対応する税目・料金番号※2が見つからない場合※4

消込情報の取消失敗※4

収納情報の更新失敗※4

－
○
－
－
○
－
－
－

9002
納付金区分が未サポートの場合に設定します。
－
○
－
－
○
－
－
－

9003
属性などが不正の場合に設定します。
－
○
－
－
○
－
－
－

（凡例）

○：該当する

－：該当しない

注※1

制御ヘッダー部のリターンコードがALL0の場合，収納業務プログラムが設定したレスポンスコードとなります。

注※2

税目・料金番号は，地方税・地公体料金の場合だけ設定します。

注※3

不正電文情報としてDBの障害情報格納用テーブルに登録されます。不正電文チェックについては，「1.6.3(2)　不正電文チェック」を参照してください。障害情報格納用テーブルについては，「5.1　DBに作成するテーブルの種類」を参照してください。

注※4

照会応答電文（1130）には，このチェックはありません。

(2)　レスポンスコード（国庫金の場合）

国庫金の場合のレスポンスコードを次に示します。

表7-29　通信サーバfor Billerが設定するレスポンスコード一覧（国庫金の場合）

レスポンスコード
説明
照会応答電文
国庫金消込応答電文
国庫金取消応答電文
国庫金再送確認応答電文
カウンタ応答電文

1120
1130※
2220
2230※
2320
2330※
2720
2730※
1620
1630

0000
処理が正常の場合に設定します。
－
－
－
－
－
－
－
－
○
－

A001
設定する場合を次に示します。

MPNセンタが未開局の場合

収納機関サービスが未起動の場合

－
○
－
－
－
○
－
－
－
－

A002
収納委託金融機関チェックエラー（収納金融機関エラー）の場合に設定します。
－
○
－
－
－
○
－
－
－
－

A003
設定する場合を次に示します。

納付番号が属性誤りの場合

OCR情報の納付番号が属性誤り（照会・取消）の場合

バーコード情報の納付番号が属性誤り（照会・取消）の場合

－
○
－
○
－
○
－
○
－
－

A004
設定する場合を次に示します。

確認番号が属性誤りの場合

OCR情報の確認番号が属性誤り（照会・取消）の場合

バーコード情報の確認番号が属性誤り（照会・取消）の場合

－
○
－
○
－
－
－
○
－
－

A010
収納委託金融機関チェックエラー（チャネルエラー）の場合に設定します。
－
○
－
－
－
－
－
－
－
－

A013
設定する場合を次に示します。

納付区分が属性誤りの場合

収納委託金融機関チェックエラー（納付区分エラー）

－
○
－
－
－
－
－
－
－
－

A301
チャネル区分が窓口以外の場合に設定します。
－
－
－
－
－
○
－
－
－
－

A601
カウンタ年月日が不正の場合に設定します。
－
－
－
－
－
－
－
－
－
○

9001
設定する場合を次に示します。

収納機関サービスの呼び出しに失敗した場合

収納機関サービスが未起動の場合（消込・再送）

収納業務プログラムの呼び出しに失敗した場合

収納業務プログラムから不正電文を受信した場合

収納委託金融機関チェックエラー

通信サーバ内部障害

－
○
－
○
－
○
－
○
－
－

9003
MPNセンタからの依頼電文が不正の場合に設定します（ほかのレスポンスコードに該当しない事象で設定）。
－
○
－
○
－
○
－
○
－
－

（凡例）

○：該当する

－：該当しない

注※

制御ヘッダー部のリターンコードがALL0の場合，収納業務プログラムが設定したレスポンスコードとなります。

7.3　収納業務受付インターフェース

収納業務受付インターフェース，およびリターンコードについて説明します。

収納業務受付インターフェースとは，収納情報の登録や照会などのDBの操作をするためのインターフェースです。DBの操作は，収納サーバから要求された収納業務プログラムが，通信サーバfor Billerの収納業務受付SPPを呼び出して行います。収納業務受付SPPは，DBの操作ごとにエントリポイントを持ち，RPC通信で電文を送受信します。

DBの操作と，該当する収納業務受付SPPのエントリポイントを次に示します。なお，収納サービスの種類によって，収納業務受付SPPの利用可否が異なります。

表7-30　DBの操作および収納業務受付SPPのエントリポイントの一覧

DB操作 | 機能説明 | エントリポイント | 収納サービスの種類
地方税・地公体料金 | 一般料金 | 国庫金
電文履歴の照会 | 電文履歴を照会します。 | hmpn_msgref_srv | ○ | ○ | ○
収納カウンタ情報の照会 | 収納カウンタ情報を照会します。 | hmpn_cntref_srv | ○ | ○ | ○
納付情報の登録 | 納付情報を新規登録します。 | hmpn_npayins_srv | ○ | × | ×
納付情報の更新 | 納付情報を更新します。 | hmpn_npayupd_srv | ○ | × | ×
納付情報の照会 | 納付情報を照会します。 | hmpn_npayref_srv | ○ | × | ×
納付情報の取消 | 納付情報を削除します。 | hmpn_npaycan_srv | ○ | × | ×
請求情報の登録 | 請求情報を新規登録します。 | hmpn_demins_srv | × | ○ | ×
請求情報の更新 | 請求情報を更新します。 | hmpn_demupd_srv | × | ○ | ×
請求情報の照会 | 請求情報を照会します。 | hmpn_demref_srv | × | ○ | ×
請求情報の取消 | 請求情報を削除します。 | hmpn_demcan_srv | × | ○ | ×
消込情報の照会 | 消込情報を照会します。 | hmpn_kpayref_srv | ○ | ○ | ○
取消情報の照会 | 消込情報，および収納情報の取消情報を照会します。 | hmpn_cpayref_srv | ○ | ○ | ×

（凡例）

○：利用できる

×：利用できない

注意

収納情報を照会してから情報の消込が行われるまでの間に，収納業務プログラムからの要求によって収納情報の更新，または取消が行われた場合，次のように処理されます。このような場合には，MPNの仕様で規定された運用で対処されます。通信サーバfor Billerでは，トレース情報および電文履歴から解析してください。

収納情報の更新が行われた場合
照会時とは異なる収納情報に対して，消込が行われます。

収納情報の取消が行われた場合
収納情報の消込が失敗します。

＜この節の構成＞

7.3.1　電文履歴の照会用インターフェース

7.3.2　収納カウンタ情報の照会用インターフェース

7.3.3　納付情報の登録用インターフェース

7.3.4　納付情報の更新用インターフェース

7.3.5　納付情報の照会用インターフェース

7.3.6　納付情報の取消用インターフェース

7.3.7　請求情報の登録用インターフェース

7.3.8　請求情報の更新用インターフェース

7.3.9　請求情報の照会用インターフェース

7.3.10　請求情報の取消用インターフェース

7.3.11　消込情報の照会用インターフェース

7.3.12　取消情報の照会用インターフェース

7.3.1　電文履歴の照会用インターフェース

電文履歴の照会用インターフェースは，収納サーバから要求された情報に該当する，DB上の電文履歴を照会するためのインターフェースです。

電文履歴の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　電文履歴の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　電文履歴の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは受信した電文中の情報に該当する，DB上の情報を参照し，収納業務プログラムに返送します。なお，電文履歴を照会するには，次の方法があります。

地方税・地公体料金の場合

納付番号，確認番号および納付区分がすべて一致する情報を照会する。

仕向センタコード，仕向処理年月日および仕向処理通番がすべて一致する情報を照会する。

一般料金の場合

お客様番号，および確認番号がすべて一致する情報を照会する。

仕向センタコード，仕向処理年月日および仕向処理通番がすべて一致する情報を照会する。

国庫金の場合

収納機関コードが国税庁（00200000）の場合
次のどちらかに一致した情報を照会する。
・納付番号，確認番号，および納付区分
・仕向センタコード，仕向処理年月日，および仕向処理通番

収納機関コードが国税庁（00200000）以外の場合
次のどちらかに一致した情報を照会する。
・納付番号および確認番号
・仕向センタコード，仕向処理年月日，および仕向処理通番

電文履歴格納用テーブルを格納する形式を次に示します。設定方法のサイズに満たないデータは次のように設定してください。

固定長データの場合，左詰めで設定し残りは半角SPACEを設定します。

データ長の場合，右詰めで設定し残りはALL0を設定します。

可変長データの場合，左詰めで設定し残りはNULLを設定します。

また，データがない項目には，NULLを設定してください。

表7-31　電文履歴格納用テーブルの形式

項目名
内容
項目属性
サイズ
（単位：バイト）
データ型

BILLER_RTN_CODE
リターンコード
CHAR
8
固定長データ

BILLER_MSG_ID
電文ID
CHAR
4
データ長

CHAR
48
可変長データ

MSG_TYPE
電文種別コード
CHAR
4
固定長データ

RECV_CODE
収納機関コード
CHAR
8
固定長データ

CUST_NO
お客様番号（納付番号）
CHAR
4
データ長

CHAR
20
可変長データ

CONF_NO
確認番号
CHAR
4
データ長

CHAR
6
可変長データ

PAY_CLS
納付区分
CHAR
4
データ長

CHAR
16
可変長データ

SRC_CODE
仕向センタコード
CHAR
10
固定長データ

SRC_PROCDATE
仕向処理年月日
CHAR
8
固定長データ

SRC_PROCNUM
仕向処理通番
CHAR
8
固定長データ

MSG_BODY
電文
CHAR
4
データ長

CHAR
5,297
可変長データ

RPC_FLAG
RPC結果フラグ
CHAR
1
固定長データ

PROC_RESULT
電文処理結果
CHAR
2
固定長データ

PROD_DATE
作成日
CHAR
10
固定長データ

PROD_TIME
作成時刻
CHAR
8
固定長データ

合計
5,474
－

（凡例）

－：該当なし

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，電文履歴照会用のサービスグループ名およびサービス名を指定します。

入力情報
次のどちらかの形式で通信サーバfor Billerに電文を送信します。

表7-32　要求電文への設定項目（電文履歴照会：納付番号，確認番号などで照会する場合）

項目名
内容
属性
サイズ（単位：バイト）

収納業務ID長※1
収納業務ID長
unsigned int
－

収納業務ID※2
収納業務受付に対するユニークなID
char
（収納業務ID長）

収納機関コード
収納機関コード
char
8

照会種別
照会種別
「0」：納付番号，確認番号，および納付区分がすべて一致する情報を照会します。
char
1

お客様番号（納付番号）
お客様番号（納付番号）の長さ
char
4

お客様番号（納付番号）
char
20

確認番号
確認番号の長さ
char
4

確認番号
char
6

納付区分※3
納付区分の長さ
char
4

納付区分
char
16

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

地方税・地公体料金の場合，または国庫金で収納機関コードが国税庁（00200000）の場合，指定します。

表7-33　要求電文への設定項目（電文履歴照会：仕向センタコード，仕向処理年月日および仕向処理通番で照会する場合）

項目名
内容
属性
サイズ（単位：バイト）

収納業務ID長※1
収納業務ID長
unsigned int
－

収納業務ID※2
収納業務受付に対するユニークなID
char
（収納業務ID長）

収納機関コード
収納機関コード
char
8

照会種別
照会種別
「1」：仕向センタコード，仕向処理年月日および仕向処理通番がすべて一致する情報を照会します。
char
1

仕向センタコード
仕向センタコード
char
10

仕向処理年月日
仕向処理年月日
char
8

仕向処理通番
仕向処理通番
char
8

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する，出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-34　応答電文への設定項目（電文履歴照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長の領域 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
電文履歴照会件数 | 電文履歴照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
電文履歴レコード長※4 | DBに格納されている電文履歴レコード長 | unsigned int | －
電文履歴レコード※4 | DBに格納されている電文履歴レコード | char | （電文履歴レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が電文履歴レコードより小さい場合，残照会件数に値が設定されます。

注※4

複数件照会する場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる電文履歴がない（電文履歴照会件数が0件）場合，電文履歴レコード長，および電文履歴レコードはありません。

7.3.2　収納カウンタ情報の照会用インターフェース

収納カウンタ情報の照会用インターフェースは，収納サーバから要求された情報に該当するDB上の情報を照会するためのインターフェースです。

収納カウンタ情報の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　収納カウンタ情報の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　収納カウンタ情報の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは，受信した電文中の情報に該当する，DB上の情報を参照し，収納業務プログラムに返送します。なお，収納カウンタ情報を照会するには，次の方法があります。

カウンタ照会年月日が一致する情報を照会する

カウンタ照会年月日およびカウンタ取得タイプがすべて一致する情報を照会する

収納カウンタ情報レコードを格納する形式を次に示します。設定方法のサイズに満たないデータは，左詰めで設定し残りは半角SPACEを設定してください。

また，データがない項目には，NULLを設定してください。

表7-35　収納カウンタ情報格納用テーブルの形式

項目名
内容
項目属性
サイズ
（単位：バイト）
データ型

RECV_CODE
収納機関コード
CHAR
8
固定長データ

CNT_ACQR_TYPE
カウンタ取得タイプ
CHAR
1
固定長データ

INQ_DATE
カウンタ照会年月日
CHAR
8
固定長データ

CNT_DATE1
カウンタ年月日1
CHAR
8
固定長データ

INQ_CNT1
照会件数1
CHAR
8
固定長データ

PAY_CNT1
消込件数1
CHAR
8
固定長データ

PAY_AMT1
消込金額1
CHAR
14
固定長データ

CAN_CNT1
取消件数1
CHAR
8
固定長データ

CAN_AMT1
取消金額1
CHAR
14
固定長データ

CNT_DATE2
カウンタ年月日2
CHAR
8
固定長データ

INQ_CNT2
照会件数2
CHAR
8
固定長データ

PAY_CNT2
消込件数2
CHAR
8
固定長データ

PAY_AMT2
消込金額2
CHAR
14
固定長データ

CAN_CNT2
取消件数2
CHAR
8
固定長データ

CAN_AMT2
取消金額2
CHAR
14
固定長データ

PROD_DATE
作成日
CHAR
10
固定長データ

PROD_TIME
作成時刻
CHAR
8
固定長データ

合計
155
－

（凡例）

－：該当なし

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，収納カウンタ情報照会用のサービスグループ名およびサービス名を指定します。

入力情報
次のどちらかの形式で通信サーバfor Billerに電文を送信します。

表7-36　要求電文への設定項目（収納カウンタ情報照会：カウンタ照会年月日で照会する場合）

項目名
内容
属性
サイズ（単位：バイト）

収納業務ID長※1
収納業務ID長
unsigned int
－

収納業務ID※2
収納業務受付に対するユニークなID
char
（収納業務ID長）

収納機関コード※3
収納機関コード
char
8

照会種別
照会種別

「0」：カウンタ照会年月日が一致する最新情報を照会します。

「1」：カウンタ照会年月日が一致するすべての情報を照会します。

char
1

カウンタ照会年月日
カウンタ照会年月日
char
8

（凡例）

－：該当なし

表7-37　要求電文への設定項目（収納カウンタ情報照会：カウンタ照会年月日とカウンタ取得タイプで照会する場合）

項目名
内容
属性
サイズ（単位：バイト）

収納業務ID長※1
収納業務ID長
unsigned int
－

収納業務ID※2
収納業務受付に対するユニークなID
char
（収納業務ID長）

収納機関コード※3
収納機関コード
char
8

照会種別
照会種別

「2」：カウンタ照会年月日とカウンタ取得タイプが一致する，最新情報を照会します。

「3」：カウンタ照会年月日とカウンタ取得タイプが一致する，すべての情報を照会します。

char
1

カウンタ照会年月日
カウンタ照会年月日
char
8

カウンタ取得タイプ
カウンタ取得タイプ

「0」：収納カウンタ情報取得コマンド（hmpncntget）を使用して任意のタイミングで取得した収納カウンタ情報。

「1」：閉局したときに取得した収納カウンタ情報。

char
1

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

収納機関コードには，ALL0を指定してください。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する，出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-38　応答電文への設定項目（収納カウンタ情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID（収納業務ID長のサイズ） | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
カウンタ照会件数 | カウンタ照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
収納カウンタ情報レコード長※4 | DBに格納されている収納カウンタ情報レコード長 | unsigned int | －
収納カウンタ情報レコード※4 | DBに格納されている収納カウンタ情報レコード | char | （収納カウンタ情報レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が収納カウンタ情報レコードより小さい場合，残照会件数に値が設定されます。

注※4

消込情報が複数件ある場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる収納カウンタ情報がない（カウンタ照会件数が0件）場合，収納カウンタ情報レコード長，および収納カウンタ情報レコードはありません。

7.3.3　納付情報の登録用インターフェース

納付情報の登録用インターフェースとは，収納サーバから要求された情報をDBに格納するためのインターフェースです。

納付情報の登録要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　納付情報の登録要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　納付情報の登録要求電文の流れ

収納業務プログラムは，収納業務受付SPPに登録要求電文を送信します。収納業務受付SPPは，受信した電文中の納付情報をDBに格納します。

納付情報レコードを格納する形式を次に示します。設定方法のサイズに満たないデータは次のように設定してください。

固定長データの場合，左詰めで設定し残りは半角SPACEを設定します。

固定長データ（漢字）の場合，左詰めで設定し残りは全角SPACEを設定します。

データ長の場合，右詰めで設定し残りはALL0を設定します。

可変長データの場合，右詰めで設定し残りはNULLを設定します。

また，データがない項目には，NULLを設定してください。

表7-39　納付情報格納用テーブルの形式

項目名
内容
項目属性
サイズ
（単位：バイト）
データ型

RECV_CODE
収納機関コード
CHAR
8
固定長データ

CUST_NO
お客様番号（納付番号）
CHAR
4
データ長

CHAR
20
可変長データ

CONF_NO
確認番号
CHAR
4
データ長

CHAR
6
可変長データ

PAY_CLS
納付区分
CHAR
4
データ長

CHAR
16
可変長データ

OCR_INFO
OCR情報
CHAR
83
固定長データ

BARCODE_INFO
バーコード情報
CHAR
4
データ長

CHAR
50
可変長データ

PAY_FORM
支払形態
CHAR
1
固定長データ

USER_NAME_KANA
利用者名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

USER_NAME_KANJI
利用者名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

PASSWD
パスワード
CHAR
4
データ長

CHAR
20
可変長データ

RECV_NAME_KANA
収納機関名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

RECV_NAME_KANJI
収納機関名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

ID_NO
識別番号
CHAR
20
固定長データ

PAY_DOC_TYPE
払込書区分
CHAR
1
固定長データ

PAY_TOTAL
納付合計額
CHAR
11
固定長データ

PAY_AMT
納付額
CHAR
11
固定長データ

ARRE_SHOW_TYPE
延滞金表示区分
CHAR
1
固定長データ

OVERDUE
延滞金
CHAR
8
固定長データ

COMM_BRDN_TYPE
手数料負担区分
CHAR
1
固定長データ

PAY_CONT_KANA
納付内容（カナ）
CHAR
24
固定長データ

PAY_CONT_KANJI
納付内容（漢字）
CHAR
24
固定長データ（漢字）

DEMAND
督促手数料
CHAR
11
固定長データ

PREPAID
前納報奨金
CHAR
11
固定長データ

PUBLIC_OPTION
地公体任意情報
CHAR
4
データ長

CHAR
20
可変長データ

CHARGE_TYPE
手数料負担区分
CHAR
1
固定長データ

PAY_LIMIT_DATE
消込期限年月日
CHAR
8
固定長データ

PAY_MTHD
納付方式
CHAR
1
固定長データ

DETAIL_PRNT_KANA
詳細印字（カナ）
CHAR
24
固定長データ

DETAIL_PRNT_KANJI
詳細印字（漢字）
CHAR
24
固定長データ（漢字）

DETAIL_SHOW1_KANA
詳細表示1（カナ）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW1_KANJI
詳細表示1（漢字）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW2_KANA
詳細表示2（カナ）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW2_KANJI
詳細表示2（漢字）
CHAR
4
データ長

CHAR
150
可変長データ

PAY_YEAR
納付年度
CHAR
4
固定長データ

PAY_STP_INFO
支払停止情報
CHAR
1
固定長データ

PAY_STP_CHANNEL
支払停止チャネル
CHAR
1
固定長データ

NONPYA_SHOW_INFO
未納表示情報
CHAR
1
固定長データ

EXTRA_INFO
期割情報
CHAR
2
固定長データ

REPLACE_INFO
差替情報
CHAR
1
固定長データ

PAID_FLAG
支払済フラグ
CHAR
1
固定長データ

CAN_FLAG
取消停止フラグ
CHAR
1
固定長データ

YOBI※
予備
CHAR
360
固定長データ

PAY_CNT
消込カウンタ
CHAR
4
固定長データ

CAN_CNT
取消カウンタ
CHAR
4
固定長データ

PROD_DATE
作成日
CHAR
10
固定長データ

PROD_TIME
作成時刻
CHAR
8
固定長データ

合計
1,555
－

（凡例）

－：該当なし

注※

任意で使用できる領域です。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，納付情報登録用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-40　要求電文への設定項目（納付情報登録の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
納付情報レコード長 | 納付情報レコード長 | unsigned int | －
納付情報レコード | 登録する納付情報レコード | char | （納付情報レコード長）

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに応答電文を返送します。

表7-41　応答電文への設定項目（納付情報登録の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，または納付情報レコードが納付情報格納用テーブルの形式に合っていない場合は，「収納業務ID長+収納業務ID+リターンコード」が応答電文として返送されます。

7.3.4　納付情報の更新用インターフェース

納付情報の更新用インターフェースとは，収納サーバから要求された情報に該当する，DB上の納付情報を更新するためのインターフェースです。

納付情報の更新要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　納付情報の更新要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　納付情報の更新要求電文の流れ

収納業務プログラムは，収納業務受付SPPに更新要求電文を送信します。収納業務受付SPPは，受信した電文中の納付情報に該当する，DB上の納付情報を削除し，新たに電文中の納付情報をDBに格納します。なお，更新する納付情報は，受信した電文中の納付番号，確認番号および納付区分によって指定されます。

納付情報を格納する形式については，「7.3.3　納付情報の登録用インターフェース」を参照してください。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，納付情報更新用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-42　要求電文への設定項目（納付情報更新の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
納付番号 | 納付番号の長さ | char | 4
納付番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6
納付区分 | 納付区分の長さ | char | 4
納付区分 | char | 16
納付情報レコード長 | 納付情報レコード長 | unsigned int | －
納付情報レコード | 更新する納付情報レコード | char | （納付情報レコード長）

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-43　応答電文への設定項目（納付情報更新の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

7.3.5　納付情報の照会用インターフェース

納付情報の照会用インターフェースは，収納サーバから要求された情報に該当する，DB上の納付情報を照会するためのインターフェースです。

納付情報の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　納付情報の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　納付情報の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは，該当するDB上の納付情報を参照し，収納業務プログラムに返送します。照会する納付情報は，受信した電文中の納付番号，確認番号および納付区分によって指定されます。

納付情報レコードを格納する形式については，「7.3.3　納付情報の登録用インターフェース」を参照してください。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，納付情報照会用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-44　要求電文への設定項目（納付情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
納付番号 | 納付番号の長さ | char | 4
納付番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号または「*（先頭1バイト）」※3 | char | 6
納付区分 | 納付区分の長さ | char | 4
納付区分 | char | 16

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

確認番号の先頭に1バイトの「*」を設定した場合，納付番号と納付区分から，該当する納付情報が検索されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-45　応答電文への設定項目（納付情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
納付情報照会件数 | 納付情報照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
納付情報レコード長※4 | DBに格納されている納付情報レコード長 | unsigned int | －
納付情報レコード※4 | DBに格納されている納付情報レコード | char | （納付情報レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が納付情報レコードより小さい場合，残照会件数に値が設定されます。

注※4

照会情報が複数件ある場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，または納付情報レコードが納付情報格納用テーブルの形式に合っていない場合は，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる納付情報がない（納付情報照会件数が0件）場合，納付情報レコード長，および納付情報レコードはありません。

7.3.6　納付情報の取消用インターフェース

納付情報の取消用インターフェースとは，収納サーバから要求された情報に該当する，DB上の情報を削除するためのインターフェースです。

納付情報の取消要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を返送するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を送信するときに設定する項目について説明します。

＜この項の構成＞

(1)　納付情報の取消要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　納付情報の取消要求電文の流れ

収納業務プログラムは，収納業務受付SPPに取消要求電文を送信します。収納業務受付SPPは，受信した電文中の納付情報に該当する，DB上の納付情報を削除します。なお，削除する納付情報は，受信した電文中の納付番号，確認番号および納付区分によって指定されます。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，納付情報取消用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-46　要求電文への設定項目（納付情報取消の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
納付番号 | 納付番号の長さ | char | 4
納付番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6
納付区分 | 納付区分の長さ | char | 4
納付区分 | char | 16

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-47　応答電文への設定項目（納付情報取消の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

7.3.7　請求情報の登録用インターフェース

請求情報の登録用インターフェースとは，収納サーバから要求された情報をDBに格納するためのインターフェースです。

請求情報の登録要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　請求情報の登録要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　請求情報の登録要求電文の流れ

収納業務プログラムは，収納業務受付SPPに登録要求電文を送信します。収納業務受付SPPは，受信した電文中の請求情報をDBに格納します。

請求情報レコードを格納する形式を次に示します。設定方法のサイズに満たないデータは次のように設定してください。

固定長データの場合，左詰めで設定し残りは半角SPACEを設定します。

固定長データ（漢字）の場合，左詰めで設定し残りは全角SPACEを設定します。

データ長の場合，右詰めで設定し残りはALL0を設定します。

可変長データの場合，右詰めで設定し残りはNULLを設定します。

また，データがない項目には，NULLを設定してください。

表7-48　請求情報格納用テーブルの形式

項目名
内容
項目属性
サイズ
（単位：バイト）
データ型

RECV_CODE
収納機関コード
CHAR
8
固定長データ

CUST_NO
お客様番号（納付番号）
CHAR
4
データ長

CHAR
20
可変長データ

CONF_NO
確認番号
CHAR
4
データ長

CHAR
6
可変長データ

OCR_INFO
OCR情報
CHAR
83
固定長データ

BARCODE_INFO
バーコード情報
CHAR
4
データ長

CHAR
50
可変長データ

PAY_FORM
支払形態
CHAR
1
固定長データ

USER_NAME_KANA
利用者名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

USER_NAME_KANJI
利用者名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

PASSWD
パスワード
CHAR
4
データ長

CHAR
20
可変長データ

RECV_NAME_KANA
収納機関名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

RECV_NAME_KANJI
収納機関名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

BILL_NO
請求番号
CHAR
20
固定長データ

PAY_DOC_TYPE
払込書区分
CHAR
1
固定長データ

BILL_TOTAL
請求金額
CHAR
11
固定長データ

BILL_PRINCIPAL
請求金額元金
CHAR
11
固定長データ

OVERDUE_DISP
延滞金表示区分
CHAR
1
固定長データ

OVERDUE
延滞金
CHAR
8
固定長データ

TAX_DISP
消費税額表示区分
CHAR
1
固定長データ

TAX
消費税額
CHAR
10
固定長データ

COMM_BRDN_TYPE
手数料負担区分
CHAR
1
固定長データ

BILL_CONT_KANA
請求内容（カナ）
CHAR
24
固定長データ

BILL_CONT_KANJI
請求内容（漢字）
CHAR
24
固定長データ

CHARGE_TYPE
手数料負担区分
CHAR
1
固定長データ

PAY_LIMIT_DATE
消込期限年月日
CHAR
8
固定長データ

DETAIL_PRNT_KANA
詳細印字（カナ）
CHAR
24
固定長データ

DETAIL_PRNT_KANJI
詳細印字（漢字）
CHAR
24
固定長データ

DETAIL_SHOW1_KANA
詳細表示１（カナ）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW1_KANJI
詳細表示１（漢字）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW2_KANA
詳細表示２（カナ）
CHAR
4
データ長

CHAR
150
可変長データ

DETAIL_SHOW2_KANJI
詳細表示２（漢字）
CHAR
4
データ長

CHAR
150
可変長データ

PAY_YEAR
請求年度
CHAR
4
固定長データ

PAY_STP_INFO
支払停止情報
CHAR
1
固定長データ

PAY_STP_CHANNEL
支払停止チャネル
CHAR
1
固定長データ

NONPYA_SHOW_INFO
未納表示情報
CHAR
1
固定長データ

EXTRA_INFO
ソート情報
CHAR
2
固定長データ

REPLACE_INFO
差替情報
CHAR
1
固定長データ

PAID_FLAG
支払済フラグ
CHAR
1
固定長データ

CAN_FLAG
取消停止フラグ
CHAR
1
固定長データ

YOBI※
予備
CHAR
360
固定長データ

PAY_CNT
消込カウンタ
CHAR
4
固定長データ

CAN_CNT
取消カウンタ
CHAR
4
固定長データ

PROD_DATE
作成日
CHAR
10
固定長データ

PROD_TIME
作成時刻
CHAR
8
固定長データ

合計
1,499
－

（凡例）

－：該当なし

注※

任意で使用できる領域です。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，請求情報登録用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-49　要求電文への設定項目（請求情報登録の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
請求情報レコード長 | 請求情報レコード長 | unsigned int | －
請求情報レコード | 登録する請求情報レコード | char | （請求情報レコード長）

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに応答電文を返送します。

表7-50　応答電文への設定項目（請求情報登録の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，または請求情報レコードが請求情報格納用テーブルの形式に合っていない場合は，「収納業務ID長+収納業務ID+リターンコード」が応答電文として返送されます。

7.3.8　請求情報の更新用インターフェース

請求情報の更新用インターフェースとは，収納サーバから要求された情報に該当する，DB上の請求情報を更新するためのインターフェースです。

請求情報の更新要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　請求情報の更新要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　請求情報の更新要求電文の流れ

収納業務プログラムは，収納業務受付SPPに更新要求電文を送信します。収納業務受付SPPは，受信した電文中の請求情報に該当する，DB上の請求情報を削除し，新たに電文中の請求情報をDBに格納します。なお，更新する請求情報は，受信した電文中のお客様番号，および確認番号によって指定されます。

請求情報を格納する形式については，「7.3.7　請求情報の登録用インターフェース」を参照してください。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，請求情報更新用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-51　要求電文への設定項目（請求情報更新の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
お客様番号 | お客様番号の長さ | char | 4
お客様番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6
請求情報レコード長 | 請求情報レコード長 | unsigned int | －
請求情報レコード | 更新する請求情報レコード | char | （請求情報レコード長）

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-52　応答電文への設定項目（請求情報更新の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

7.3.9　請求情報の照会用インターフェース

請求情報の照会用インターフェースは，収納サーバから要求された情報に該当する，DB上の納付情報を照会するためのインターフェースです。

請求情報の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　請求情報の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　請求情報の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは，該当するDB上の請求情報を参照し，収納業務プログラムに返送します。照会する請求情報は，受信した電文中のお客様番号，および確認番号によって指定されます。

請求情報レコードを格納する形式については，「7.3.7　請求情報の登録用インターフェース」を参照してください。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，請求情報照会用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-53　要求電文への設定項目（請求情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
お客様番号 | お客様番号の長さ | char | 4
お客様番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号または「*（先頭1バイト）」※3 | char | 6

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

確認番号の先頭に1バイトの「*」を設定した場合，お客様番号から，該当する請求情報が検索されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-54　応答電文への設定項目（請求情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
請求情報照会件数 | 請求情報照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
請求情報レコード長※4 | DBに格納されている請求情報レコード長 | unsigned int | －
請求情報レコード※4 | DBに格納されている請求情報レコード | char | （請求情報レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が請求情報レコードより小さい場合，残照会件数に値が設定されます。

注※4

照会情報が複数件ある場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，または請求情報レコードが請求情報格納用テーブルの形式に合っていない場合は，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる請求情報がない（請求情報照会件数が0件）場合，請求情報レコード長，および請求情報レコードはありません。

7.3.10　請求情報の取消用インターフェース

請求情報の取消用インターフェースとは，収納サーバから要求された情報に該当する，DB上の情報を削除するためのインターフェースです。

請求情報の取消要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を返送するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を送信するときに設定する項目について説明します。

＜この項の構成＞

(1)　請求情報の取消要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　請求情報の取消要求電文の流れ

収納業務プログラムは，収納業務受付SPPに取消要求電文を送信します。収納業務受付SPPは，受信した電文中の納付情報に該当する，DB上の請求情報を削除します。なお，削除する請求情報は，受信した電文中のお客様番号および確認番号によって指定されます。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，請求情報取消用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-55　要求電文への設定項目（請求情報取消の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
お客様番号 | お客様番号の長さ | char | 4
お客様番号 | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-56　応答電文への設定項目（請求情報取消の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

出力情報長
出力情報に設定した電文長を指定します。

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

7.3.11　消込情報の照会用インターフェース

消込情報の照会用インターフェースとは，収納サーバから要求された情報に該当する，DB上の消込情報を照会するためのインターフェースです。

消込情報の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を返送するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を送信するときに設定する項目について説明します。

＜この項の構成＞

(1)　消込情報の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　消込情報の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは，受信した電文中の収納情報に該当するDB上の消込情報レコードを参照し，収納業務プログラムに返送します。なお，照会する消込情報は，次に示す受信した電文中の項目によって指定されます。

地方税・地公体料金の場合

納付番号，確認番号，および納付区分

一般料金の場合

お客様番号および確認番号

国庫金の場合

収納機関コードが国税庁（00200000）の場合
納付番号，確認番号，および納付区分

収納機関コードが国税庁（00200000）以外の場合
納付番号および確認番号

消込情報格納用テーブルを格納する形式を次に示します。設定方法のサイズに満たないデータは次のように設定してください。

固定長データの場合，左詰めで設定し残りは半角SPACEを設定します。

データ長の場合，右詰めで設定し残りはALL0を設定します。

可変長データの場合，左詰めで設定し残りはNULLを設定します。

また，データがない項目には，NULLを設定してください。

表7-57　消込情報格納用テーブルの形式

項目名
内容
項目属性
サイズ
（単位：バイト）
データ型

RECV_CODE
収納機関コード
CHAR
8
固定長データ

CUST_NO
お客様番号（納付番号）
CHAR
4
データ長

CHAR
20
可変長データ

CONF_NO
確認番号
CHAR
4
データ長

CHAR
6
可変長データ

PAY_CLS
納付区分
CHAR
4
データ長

CHAR
16
可変長データ

SRC_TRX
仕向トランザクション番号
CHAR
5
固定長データ

DST_TRX
被仕向トランザクション番号
CHAR
5
固定長データ

SRC_CODE
仕向センタコード
CHAR
10
固定長データ

DST_CODE
被仕向センタコード
CHAR
10
固定長データ

BANK_CODE
金融機関コード
CHAR
8
固定長データ

BRANCH_CODE
店舗コード
CHAR
6
固定長データ

SRC_PROCDATE
仕向処理年月日
CHAR
8
固定長データ

SRC_PROCTIME
仕向処理時刻
CHAR
6
固定長データ

SRC_PROCNUM
仕向処理通番
CHAR
8
固定長データ

MPN_PROCDATE
MPN処理年月日
CHAR
8
固定長データ

MPN_PROCTIME
MPN処理時刻
CHAR
6
固定長データ

MPN_PROCNUM
MPN処理通番
CHAR
10
固定長データ

PAYMENT
精査金額
CHAR
11
固定長データ

ORIGIN_MSG_TYPE
オリジナル電文種別コード
CHAR
4
固定長データ

ORIGIN_RES_CODE
オリジナルレスポンスコード
CHAR
4
固定長データ

RES_CODE
レスポンスコード
CHAR
4
固定長データ

AGENCY_CODE
歳入代理店金融機関コード
CHAR
8
固定長データ

CHANNEL_TYPE
チャネル区分
CHAR
2
固定長データ

PAY_TYPE
納付金区分
CHAR
2
固定長データ

IN_TYPE
入力区分
CHAR
2
固定長データ

OCR_INFO
OCR情報
CHAR
83
固定長データ

BARCODE_INFO
バーコード情報
CHAR
4
データ長

CHAR
50
可変長データ

PAY_FORM
支払い形態
CHAR
1
固定長データ

BILL_INFO
請求情報
CHAR
4
データ長

CHAR
115
可変長データ

IS_INQ
照会有無
CHAR
1
固定長データ

RECEIPT_DATE
入金日
CHAR
8
固定長データ

CHECK_AMT
他店券金額
CHAR
11
固定長データ

USER_NAME_KANA
利用者名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

USER_NAME_KANJI
利用者名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

RECV_NAME_KANA
収納機関名（カナ）
CHAR
4
データ長

CHAR
24
可変長データ

RECV_NAME_KANJI
収納機関名（漢字）
CHAR
4
データ長

CHAR
24
可変長データ

PAY_WAY
支払方法
CHAR
1
固定長データ

STAMP_AMT
印紙税額
CHAR
3
固定長データ

BANK_OPTION
金融機関任意情報
CHAR
4
データ長

CHAR
20
可変長データ

PAY_AMT
収納金額
CHAR
11
固定長データ

PAY_DATE
収納日
CHAR
8
固定長データ

INQ_TIME
照会時刻
CHAR
6
固定長データ

RECEIPT_TYPE
領収区分
CHAR
1
固定長データ

PAY_INFO
納付情報
CHAR
4
データ長

CHAR
132
可変長データ

PUBLIC_OPTION
地公体任意情報
CHAR
4
データ長

CHAR
20
可変長データ

CAN_FLAG
取消フラグ
CHAR
1
固定長データ

RTN_INFO
リターン情報
CHAR
8
固定長データ

PROD_DATE
作成日
CHAR
10
固定長データ

PROD_TIME
作成時刻
CHAR
8
固定長データ

合計
819
－

（凡例）

－：該当なし

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，消込情報照会用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-58　要求電文への設定項目（消込情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
お客様番号（納付番号） | お客様番号（納付番号）の長さ | char | 4
お客様番号（納付番号） | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6
納付区分※3 | 納付区分の長さ | char | 4
納付区分 | char | 16

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

地方税・地公体料金の場合，または国庫金で収納機関コードが国税庁（00200000）の場合，指定します。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-59　応答電文への設定項目（消込情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
消込情報照会件数 | 消込情報照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
消込情報レコード長※4 | DBに格納されている消込情報レコード長 | unsigned int | －
消込情報レコード※4 | DBに格納されている消込情報レコード | char | （消込情報レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が消込情報レコードより小さい場合，残照会件数に値が設定されます。

注※4

照会情報が複数件ある場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる消込情報がない（消込情報照会件数が0件）場合，消込情報レコード長，および消込情報レコードはありません。

7.3.12　取消情報の照会用インターフェース

取消情報の照会用インターフェースとは，MPNセンタからの取消依頼電文を受信したときに，該当するDB上の情報を照会するためのインターフェースです。

取消情報の照会要求電文の流れ，収納業務プログラムが通信サーバfor Billerに要求電文を送信するときに設定する項目，および通信サーバfor Billerが収納業務プログラムに応答電文を返送するときに設定する項目について説明します。

＜この項の構成＞

(1)　取消情報の照会要求電文の流れ

(2)　収納業務プログラムが設定する項目

(3)　通信サーバfor Billerが設定する項目

(1)　取消情報の照会要求電文の流れ

収納業務プログラムは，収納業務受付SPPに照会要求電文を送信します。収納業務受付SPPは，受信した電文中の収納情報に該当する，DB上の情報を参照し，収納業務プログラムに返送します。なお，照会する取消情報は，次に示す受信した電文中の項目によって指定されます。

地方税・地公体料金の場合

納付番号，確認番号，および納付区分

一般料金の場合

お客様番号および確認番号

納付情報格納用テーブル，または請求情報格納用テーブルを格納する形式については，「7.3.3　納付情報の登録用インターフェース」または「7.3.7　請求情報の登録用インターフェース」を参照してください。また，消込情報格納用テーブルを格納するための形式については，「7.3.11　消込情報の照会用インターフェース」を参照してください。

(2)　収納業務プログラムが設定する項目

サービスグループ名，サービス名
収納業務受付SPP用ユーザサービス定義に指定した，取消情報照会用のサービスグループ名およびサービス名を指定します。

入力情報
次の形式で通信サーバfor Billerに電文を送信します。

表7-60　要求電文への設定項目（取消情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※2 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
収納機関コード | 収納機関コード | char | 8
お客様番号（納付番号） | お客様番号（納付番号）の長さ | char | 4
お客様番号（納付番号） | char | 20
確認番号 | 確認番号の長さ | char | 4
確認番号 | char | 6
納付区分※3 | 納付区分の長さ | char | 4
納付区分 | char | 16

（凡例）

－：該当なし

注※1

収納業務ID長は，最大100の数値を指定できます。

注※2

この項目は省略できます。省略する場合は，収納業務ID長にALL0を設定してください。省略した場合，収納業務受付SPPの障害時に出力されるエラーメッセージの収納業務IDに「*」が表示されます。

注※3

地方税・地公体料金の場合，指定します。

入力情報長
入力情報に設定した電文長を指定します。

呼び出し方法
同期応答型RPC

出力情報
通信サーバfor Billerが応答電文として設定する出力情報の領域を指定します。

出力情報長
出力情報で設定した領域長を指定します。

(3)　通信サーバfor Billerが設定する項目

出力情報
次の形式で収納業務プログラムに電文を返送します。

表7-61　応答電文への設定項目（取消情報照会の場合）

項目名 | 内容 | 属性 | サイズ（単位：バイト）
収納業務ID長※1 | 収納業務ID長 | unsigned int | －
収納業務ID※1 | 収納業務受付に対するユニークなID | char | （収納業務ID長）
リターンコード※2 | 収納業務受付SPPからのリターンコード | char | 11
収納情報レコード長 | DBに格納されている収納情報レコード長 | unsigned int | －
収納情報レコード | 更新する収納情報レコード | char | （収納情報レコード長）
消込情報照会件数 | 消込情報照会件数 | unsigned int | －
残照会件数※3 | 出力情報の領域に入りきらなかった照会件数 | unsigned int | －
消込情報レコード長※4 | DBに格納されている消込情報レコード長 | unsigned int | －
消込情報レコード※4 | 更新する消込情報レコード | char | （消込情報レコード長）

（凡例）

－：該当なし

注※1

要求電文の値が設定されます。

注※2

正常時は，ALL0が設定されます。それ以外のリターンコードについては，マニュアル「Hitachi Multi Payment Network communications server メッセージ」を参照してください。

注※3

収納業務プログラムが設定した応答領域（出力情報長）が消込情報レコードより小さい場合，残照会件数に値が設定されます。

注※4

消込情報が複数件ある場合は，この項目が繰り返し設定されます。

出力情報長
出力情報に設定した電文長

注意

収納業務ID長が数値でない場合，収納業務ID長に指定したサイズと収納業務IDのサイズが不一致の場合，または出力情報長が小さい場合は，応答電文が返送されません。

入力情報が形式に合っていない場合，「収納業務ID長+収納業務ID+リターンコード」が，応答電文として返送されます。

照会できる消込情報がない（消込情報照会件数が0件）場合，消込情報レコード長，および消込情報レコードはありません。

7.4　エラー検出時収納業務プログラム呼び出し機能

金融機関から送られてきた電文の内容に誤りがあり，消込処理または再送確認処理でエラーが発生して仮消込として処理した場合に，収納業務プログラムに対してエラーの発生を通知できます。この機能を，エラー検出時収納業務プログラム呼び出し機能と呼びます。なお，この機能は国庫金では使用できません。

エラー検出時収納業務プログラム呼び出し機能を使用すると，仮消込として処理した場合に，仮消込情報のリターンコードを収納業務プログラムに渡すことができます。このため，収納業務プログラム側では，利用者は金融機関に料金を支払ったが，その後の通信サーバfor Billerの処理でエラーが発生して仮消込されたということを把握できます。

エラー検出時収納業務プログラム呼び出し機能を次に示します。

図7-22　エラー検出時収納業務プログラム呼び出し機能

エラー検出時収納業務プログラム呼び出し機能を使用するには，通信サーバシステム定義で次のように設定します。

共通で定義する場合
通信サーバfor Biller共通定義の「BL_ENV」に「HMPN_ERRSEND=YES」を指定します。「BL_ENV」の詳細については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

収納機関サービスごとに定義する場合
通信サーバfor Biller業務系SPP定義の「SRV_ENV」に「HMPN_ERRSEND=YES」を指定します。「SRV_ENV」の詳細については，「4.4.4(9)　通信サーバfor Biller業務系SPP定義」を参照してください。

なお，この設定をした場合，動作が次の点で異なります。

プロセス起動時に，プロセス別トレースへメッセージKDMQBS531-Iが出力されます。

金融機関から送られてきた電文の内容に誤りがありエラーを検出した場合に，仮消込情報に設定するリターンコードを，収納業務プログラムにも渡します。仮消込情報に設定するリターンコードについては，「7.1.2(3)(b)　通信サーバfor Billerが設定するリターンコード」または「7.1.5(3)(b)　通信サーバfor Billerが設定するリターンコード」を参照してください。

7.5　納付区分エラー変換機能

収納情報の照会で3桁未満の納付区分を受信した場合に，そのエラーに対するレスポンスコードを「9003」から「A013」に変換できます。この機能を，納付区分エラー変換機能と呼びます。

納付区分エラー変換機能を使用すると，収納情報の照会で3桁未満の納付区分が入力された場合に，納付区分に入力誤りがあることを金融機関の各種支払いチャネルの端末上に表示して，利用者にエラー内容を通知できます。

納付区分エラー変換機能を使用するには，通信サーバシステム定義で，通信サーバfor Biller共通定義の「BL_ENV」に「HMPN_PAY_CLSCNV=YES」を指定します。「BL_ENV」の詳細については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

なお，この設定をした場合，動作が次の点で異なります。

プロセス起動時に，プロセス別トレースへメッセージKDMQCP531-Iが出力されます。

収納情報の照会で3桁未満の納付区分エラーが発生した場合，レスポンスコードに「A013」を設定しMPNセンタに異常応答します。

8.　システム運用

この章では，通信サーバfor Billerのシステムの起動/停止，システムの管理，およびDBバッチ処理の運用方法について説明します。

＜この章の構成＞

8.1　システム運用の流れ

8.2　システムの起動と停止

8.3　システムの管理

8.4　DBバッチ処理の運用

8.1　システム運用の流れ

通信サーバfor Billerのシステム運用の流れを次に示します。ファイル初期化については，ロウ論理ボリュームを変更した場合には必ず実行します。状態表示については，通信サーバfor Billerの起動中，停止時に関係なく，必要に応じていつでも実行できます。各手順については，図中に示した個所を参照してください。

図8-1　システム運用の流れ

注意

収納業務プログラムは，収納機関サービスの起動コマンド（hmpnsvopen）の実行前に起動している必要があります。

システム運用の流れ

通常のシステム運用の流れについて説明します。

ファイル初期化
通信サーバfor Billerを起動する前に，ファイル初期化を実行します。ファイル初期化については，「8.3.3　ファイル初期化」を参照してください。

通信サーバfor Billerの起動
通信サーバfor Billerを起動します。起動方法については，「8.2.2　通信サーバfor Billerの起動」を参照してください。なお，HA構成の場合は「8.2.8　HA構成の場合の起動と停止」，クラスタ構成の場合は「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

収納機関サービスの起動
収納機関サービスを起動します。起動方法については，「8.2.3　収納機関サービスの起動」を参照してください。

通信サーバfor Billerの開局
MPNセンタとのオンライン処理を開始するために，通信サーバfor Billerを開局します。開局方法については，「8.2.4　通信サーバfor Billerの開局」を参照してください。

収納カウンタ情報取得
MPNセンタが保有している収納カウンタ情報をオンラインで取得します。必要に応じて実行してください。収納カウンタ情報取得については，「8.3.2　収納カウンタ情報取得」を参照してください。

収納機関サービスの停止
収納機関サービスを停止します。停止方法については，「8.2.5　収納機関サービスの停止」を参照してください。

通信サーバfor Billerの閉局
MPNセンタとのオンライン処理を終了するために，通信サーバfor Billerを閉局します。閉局方法については，「8.2.6　通信サーバfor Billerの閉局」を参照してください。

通信サーバfor Billerの停止
通信サーバfor Billerを停止します。停止方法については，「8.2.7　通信サーバfor Billerの停止」を参照してください。なお，HA構成の場合は「8.2.8　HA構成の場合の起動と停止」，クラスタ構成の場合は「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

必要に応じて実行するシステム運用

必要に応じて実行するシステム運用について説明します。

状態表示
通信サーバfor Billerの構成の種類，起動状態，開閉局状態および収納機関ごとの収納機関サービスの状態を表示します。どの時点でも実行できます。状態表示については，「8.3.1　状態表示」を参照してください。

DBバッチ処理の運用
DBバッチ処理の運用については，「8.4　DBバッチ処理の運用」を参照してください。

8.2　システムの起動と停止

通信サーバfor Billerのシステムの起動/停止には，通信サーバfor Billerの起動/停止，収納機関サービスの起動/停止，および通信サーバfor Billerの開局/閉局というプロセスがあります。

通信サーバfor Billerの起動/停止，収納機関サービスの起動/停止，および通信サーバfor Billerの開局/閉局の方法について説明します。

8.2.1～8.2.7で，通常のシステムの起動/停止の方法について説明します。HA構成，クラスタ構成の場合の起動/停止については，「8.2.8　HA構成の場合の起動と停止」，「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

＜この節の構成＞

8.2.1　システムを起動/停止する前に

8.2.2　通信サーバfor Billerの起動

8.2.3　収納機関サービスの起動

8.2.4　通信サーバfor Billerの開局

8.2.5　収納機関サービスの停止

8.2.6　通信サーバfor Billerの閉局

8.2.7　通信サーバfor Billerの停止

8.2.8　HA構成の場合の起動と停止

8.2.9　クラスタ構成の場合の起動と停止

8.2.1　システムを起動/停止する前に

ここでは，通信サーバfor Billerのシステムを起動/停止する手順について説明します。

＜この項の構成＞

(1)　システムの起動手順と運用時の状態

(2)　システムの停止手順と運用時の状態

(1)　システムの起動手順と運用時の状態

システムを起動する場合は，通信サーバfor Billerの起動，収納機関サービスの起動，通信サーバfor Billerの開局の順序で起動してください。

また，次のような運用をする場合は，必要に応じてシステムを起動してください。

DB操作をする場合
通信サーバfor Billerを起動します。DB操作とは次の操作です。

電文履歴の照会

収納カウンタ情報の照会

納付情報の登録

納付情報の更新

納付情報の照会

納付情報の取消

請求情報の登録

請求情報の更新

請求情報の照会

請求情報の取消

消込情報の照会

取消情報の照会

収納カウンタ情報を取得する場合
通信サーバfor Billerを起動および開局します。

クラスタ構成の場合の起動手順については，「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

(2)　システムの停止手順と運用時の状態

システムを停止する場合は，収納機関サービスの停止，通信サーバfor Billerの閉局，通信サーバfor Billerの停止の順序で停止してください。

ただし，次のような運用をする場合は，通信サーバfor Billerの閉局，収納機関サービスの停止，通信サーバfor Billerの停止の順序で停止してください。

すべての収納機関サービスの予備閉局をしたあと，収納機関サービスを停止する場合

すべての収納機関のうち最後に停止する収納機関について，予備閉局を経由して通信サーバfor Billerの閉局をしたあと，収納機関サービスを停止する場合

また，次のような運用をする場合は，必要に応じてシステムを停止してください。

一部の収納機関について，すべての収納サービスを停止する場合
一部の収納機関について，収納機関サービスを停止します。

一部の収納機関について，照会サービスを停止する場合
一部の収納機関について，収納機関サービスを予備閉局します。

すべての収納機関サービスを停止する場合
通信サーバfor Billerを閉局します。

クラスタ構成の場合の停止手順については，「8.2.9　クラスタ構成の場合の起動と停止」を参照してください。

8.2.2　通信サーバfor Billerの起動

通信サーバfor Billerを起動する前に，OpenTP1およびHiRDBを起動しておいてください。

HiRDBの起動方法については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。また，OpenTP1の起動方法については，マニュアル「分散トランザクション処理機能 OpenTP1 運用と操作」を参照してください。

通信サーバfor Billerを起動するには，次の方法があります。

自動起動

コマンドによる手動起動

自動起動とは，OpenTP1と連動して，OpenTP1の起動後に自動で起動することです。自動起動の場合は起動の操作は必要ありません。手動起動とは，コマンドを実行して起動することです。また，通信サーバシステム定義の「AUTO_START」および「AUTO_OPEN」に「AUTO」を指定することによって，通信サーバfor Billerの起動と連携して，収納機関サービスの起動および通信サーバfor Billerの開局処理ができます。

注意

通信サーバfor Billerを起動する前に，マシンのシステム日付および時刻を設定しておいてください。通信サーバfor Billerの起動中にシステム日付および時刻を変更した場合，通信サーバfor Billerがそのあと正しく動作しないおそれがあります。

前回停止時に強制停止した場合，および前回異常終了した場合は，必ず強制起動してください。

起動操作をすると，次の順序で通信サーバfor Billerの各プロセスが起動されます。

共通ソフトウェア

収納カウンタ情報取得SPP，収納業務受付SPP

制御電文受信CUP，業務電文受信CUP

監視プロセス

各プロセスについては，「1.5.1　通信サーバfor Billerのプロセス構造」を参照してください。

＜この項の構成＞

(1)　自動起動

(2)　コマンドによる手動起動

(1)　自動起動

通信サーバシステム定義の「BL_AUTO_START」に「AUTO」が設定されている場合は，OpenTP1の起動時に自動で起動されます。

注意

前回停止時に強制停止した場合は，自動で起動されません。コマンドの強制起動オプションを指定して手動起動してください。

(2)　コマンドによる手動起動

通信サーバシステム定義の「BL_AUTO_START」に「MANUAL」が設定されている場合は，手動で起動します。手動起動する場合は通信サーバfor Billerの起動コマンド（hmpnstart）を実行してください。また，OpenTP1の障害などで通信サーバfor Billerが障害停止した場合，強制起動してください。

停止時の通信サーバfor Billerの開閉局状態を引き継がないで起動したい場合

オプションに「-F」を指定します。また，自動開局定義に従って，通信サーバfor Billerの開閉局処理をします。この場合に強制起動したあとの通信サーバfor Billerの開閉局状態を次に示します。

表8-1　強制起動後の通信サーバfor Billerの開閉局状態（-Fの場合）

障害停止時 | 強制起動後
開閉局状態 | 自動開局定義（AUTO_OPEN） | 開閉局状態
開局中 | MANUAL | 閉局中
AUTO | 開局中※
開局処理中 | MANUAL | 閉局中
AUTO | 開局中※
閉局処理中 | MANUAL | 閉局中
AUTO | 開局中※
閉局中 | MANUAL | 閉局中
AUTO | 開局中※

注※

共通ソフトウェアのすべてのチャネルがRUNNINGの場合だけ，開局中になります。

停止時の通信サーバfor Billerの開閉局状態を引き継いで起動したい場合

オプションに「-R」を指定します。停止時の通信サーバfor Billerの開閉局状態を引き継ぐため，自動開局定義は関係ありません。この場合に強制起動したあとの通信サーバfor Billerの開閉局状態を次に示します。

表8-2　強制起動後の通信サーバfor Billerの開閉局状態（-Rの場合）

障害停止時 | 強制起動後
開閉局状態 | 自動開局定義（AUTO_OPEN） | 開閉局状態
開局中 | MANUAL | 開局中
AUTO
開局処理中 | MANUAL
AUTO
閉局処理中 | MANUAL | 閉局中
AUTO
閉局中 | MANUAL
AUTO

注意

開閉局処理をするのは，共通ソフトウェアのチャネルが一つ以上RUNNINGの場合だけです。

通信サーバfor Billerの自動開局および手動開局については，「8.2.4　通信サーバfor Billerの開局」を参照してください。また，通信サーバfor Billerの起動コマンドの詳細については，「10.3　コマンドの詳細　hmpnstart（通信サーバfor Billerの起動）」を参照してください。

8.2.3　収納機関サービスの起動

収納機関サービスの起動とは，収納機関の収納サービスを開始するための操作です。なお，収納業務プログラムは，収納機関サービスの起動コマンド（hmpnsvopen）の実行前に起動しておいてください。収納機関サービスの起動には次の方法があります。

自動起動

コマンドによる手動起動

自動起動とは，プロセス起動後に自動で起動することです。自動起動の場合は起動の操作は必要ありません。手動起動とは，コマンドを実行して起動することです。起動すると，業務系SPPが起動されます。

注意

業務系SPPの起動に失敗した場合でも，通信サーバシステム定義の「AUTO_OPEN」に「AUTO」が設定されていると，通信サーバfor Billerが自動開局されます。通信サーバfor Billerの自動開局については，「8.2.4(1)　自動開局」を参照してください。

＜この項の構成＞

(1)　自動起動

(2)　コマンドによる手動起動

(1)　自動起動

通信サーバシステム定義の収納機関別に指定する「AUTO_START」に「AUTO」が設定されている場合は，プロセス起動時に収納機関サービスが自動起動されます。

通信サーバシステム定義については，「4.4　通信サーバシステム定義」を参照してください。

(2)　コマンドによる手動起動

通信サーバシステム定義の「AUTO_START」に「MANUAL」が設定されている場合は，手動で起動します。

手動起動する場合は，収納機関サービスの起動コマンド（hmpnsvopen）のオプションに「-a」または「-s」を指定して実行してください。

オプションに「-a」を指定した場合
通信サーバシステム定義に定義してあるすべての収納機関の収納機関サービスを起動します。

オプションに「-s収納機関コード」を指定した場合
指定した収納機関の収納機関サービスを起動します。

収納機関サービスの起動コマンドの詳細については，「10.3　コマンドの詳細　hmpnsvopen（収納機関サービスの起動）」を参照してください。

8.2.4　通信サーバfor Billerの開局

通信サーバfor Billerの開局とは，オンライン処理を開始するために，MPNセンタとの開局処理をする操作です。通信サーバシステム定義の「CHANNEL_NAME」に指定したチャネルがすべてRUNNINGの場合，開局します。通信サーバfor Billerの開局には，次の方法があります。

自動開局

コマンドによる手動開局

自動開局とは，通信サーバfor Billerの起動後に自動で開局することです。自動開局の場合は開局の操作は必要ありません。手動開局とは，コマンドを実行して開局することです。開局後は，開閉局状態が「開局中」になっていることを確認してください。開閉局状態の確認方法については，「8.3.1　状態表示」を参照してください。

注意

MPNセンタと通信サーバfor Billerの開閉局状態が一致しない場合は，強制開局してください。

＜この項の構成＞

(1)　自動開局

(2)　コマンドによる手動開局

(1)　自動開局

通信サーバシステム定義の「AUTO_OPEN」に「AUTO」が設定されている場合は，通信サーバfor Billerの起動時に自動開局されます。

(2)　コマンドによる手動開局

通信サーバシステム定義の「AUTO_OPEN」に「MANUAL」が設定されている場合は，手動で開局します。手動開局する場合は，開局コマンド（hmpnopen）を実行してください。また，強制開局する場合は，開局コマンドのオプションに「-F」を指定してください。

開局コマンドの詳細については，「10.3　コマンドの詳細　hmpnopen（開局）」を参照してください。

8.2.5　収納機関サービスの停止

収納機関サービスの停止とは，収納機関の収納サービスを終了するための操作です。収納機関サービスの停止には，収納機関サービスの停止コマンド（hmpnsvclose）のオプションに「-a」または「-s」を指定して実行してください。また，指定した収納機関の収納機関サービスを強制停止する場合は「-F」を指定して実行してください。

オプションに「-a」を指定した場合
通信サーバシステム定義に定義してあるすべての収納機関の収納機関サービスを停止します。

オプションに「-s 収納機関コード -c」を指定した場合
指定した収納機関の収納機関サービスを停止します。

オプションに「-s 収納機関コード -F」を指定した場合
指定した収納機関の収納機関サービスを強制停止します。

収納機関サービスの予備閉局

収納機関サービスの予備閉局とは，指定した収納機関の照会サービスを受け付けず，消込サービスおよび取消サービスを受け付ける状態にすることです。予備閉局する収納機関は，オプションの指定によって異なります。

オプションに「-a -p」を指定した場合
通信サーバシステム定義に定義してあるすべての収納機関サービスを予備閉局します。

オプションに「-s 収納機関コード -p」を指定した場合
指定した収納機関の収納機関サービスを予備閉局します。

コマンドを実行すると，収納機関サービスの状態は「予備閉局中」になります。「予備閉局中」の状態を解除するには，収納機関サービスの起動コマンド（hmpnsvopen）を実行してください。また，予備閉局したあとに収納機関サービスの停止をするときは，収納機関サービスの停止コマンドを実行してください。

なお，クラスタ構成の場合，複数の通信サーバが起動しているため，予備閉局するときは，起動しているすべての通信サーバでコマンドを実行してください。

収納機関サービスの停止コマンドの詳細については，「10.3　コマンドの詳細　hmpnsvclose（収納機関サービスの停止）」を参照してください。

8.2.6　通信サーバfor Billerの閉局

通信サーバfor Billerの閉局とは，オンライン処理を終了するために，MPNセンタとの閉局処理をする操作です。閉局するには閉局コマンド（hmpnclose）を実行してください。なお，強制閉局する場合は，閉局コマンドのオプションに「-F」を指定してください。閉局後は，開閉局状態が「閉局中」になっていることを確認してください。

閉局コマンドの詳細については，「10.3　コマンドの詳細　hmpnclose（閉局）」を参照してください。

注意

MPNセンタと通信サーバfor Billerで開閉局状態が一致しない場合に閉局するときは，必ず強制閉局してください。

MPNセンタでの障害発生時，MPNセンタのメンテナンス時などは，MPNセンタからの終了要求によって，自動で閉局されます。

予備閉局経由閉局

通信サーバシステム定義に定義してあるすべての収納機関の収納機関サービスを予備閉局にしたあと，指定した閉局処理待ち時間を経過してから閉局する場合は，閉局コマンドのオプションに「-t」を指定してください。

8.2.7　通信サーバfor Billerの停止

通信サーバfor Billerを停止するには，通信サーバfor Billerの停止コマンド（hmpnstop）を実行してください。また，強制停止する場合は，通信サーバfor Billerの停止コマンドのオプションに「-F」を指定してください。

注意

通信サーバfor Billerを停止する場合は，あらかじめ，すべての収納機関サービスを停止しておいてください。

強制停止した場合は，次回起動時に必ず強制起動してください。

通信サーバfor Billerの開閉局状態が「開局中」，収納機関サービスが「起動中」または「予備閉局中」に停止する場合は，オプションを指定して強制停止してください。

通信サーバfor Billerの停止コマンドを実行すると，次の順序で通信サーバfor Billerの各プロセスが停止されます。

監視プロセス

制御電文受信CUP，業務電文受信CUP

収納カウンタ情報取得SPP，収納業務受付SPP

共通ソフトウェア

OpenTP1

HiRDBは，通信サーバfor Billerの各プロセスを停止させたあとに終了してください。

HiRDBの停止方法については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

各プロセスについては，「1.5.1　通信サーバfor Billerのプロセス構造」を参照してください。

通信サーバfor Billerの停止コマンドの詳細については，「10.3　コマンドの詳細　hmpnstop（通信サーバfor Billerの停止）」を参照してください。

8.2.8　HA構成の場合の起動と停止

ここでは，通信サーバfor BillerをHA構成で構築している場合の起動/停止方法について説明します。操作方法は，HA構成の形態によって異なります。HA構成の形態については，「2.3.1　HA構成の形態」を参照してください。

＜この項の構成＞

(1)　通信サーバfor Biller単独でのHA構成

(2)　通信サーバBaseと通信サーバfor Biller双方でのHA構成

(1)　通信サーバfor Biller単独でのHA構成

通信サーバfor Biller単独でのHA構成の場合，通信サーバfor Billerの起動方法，および通信サーバfor Billerの停止方法については，通常の操作方法と同様です。この構成でファイル転送機能を使用するときの，通信サーバBaseの起動方法，および通信サーバBaseの停止方法も，通常の操作方法と同様です。

なお，通信サーバfor Billerを起動させる前に，HAモニタおよびHiRDBを起動させておいてください。また，通信サーバfor Billerを停止させたあとに，HiRDBおよびHAモニタを停止させてください。

通信サーバfor Billerの起動については「8.2.2　通信サーバfor Billerの起動」を参照してください。また，通信サーバfor Billerの停止については「8.2.7　通信サーバfor Billerの停止」を参照してください。

通信サーバBaseの起動/停止方法については，マニュアル「Hitachi Multi Payment Network communications server Base」を参照してください。

(2)　通信サーバBaseと通信サーバfor Biller双方でのHA構成

通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合，通信サーバの起動，および通信サーバの停止は，次の手順で行います。

(a)　通信サーバの起動

HAモニタおよびHiRDBを起動する
HAモニタおよびHiRDBの起動方法については，マニュアル「高信頼化システム監視機能 HAモニタ」，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

通信サーバBaseを起動する
現用系，予備系ともにHAモニタのコマンド（monbegin）を実行してください。

通信サーバfor Billerを起動する
通常の操作方法と同様に，通信サーバfor Billerを起動してください。通常の操作方法については，「8.2.2　通信サーバfor Billerの起動」を参照してください。

強制起動する場合は，通信サーバfor Billerの起動コマンド（hmpnstart）にオプションを指定してください。

HAモニタのコマンドの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

(b)　通信サーバの停止

通信サーバBaseを停止する
現用系でHAモニタのコマンド（monend）を実行してください。予備系は現用系と連動して停止します。

通信サーバfor Billerを停止する
現用系，予備系ともに通信サーバfor Billerの停止コマンド（hmpnstop）を実行してください。

HiRDBおよびHAモニタを停止する

強制停止する場合は，通信サーバfor Billerの停止コマンドのオプションに「-F」を指定してください。また，通信サーバfor Billerを停止させたあとに，HiRDBおよびHAモニタを停止させてください。

通信サーバの停止のこのほかの操作については，「8.2.7　通信サーバfor Billerの停止」を参照してください。また，HAモニタのコマンドの詳細については，マニュアル「高信頼化システム監視機能 HAモニタ」を参照してください。

8.2.9　クラスタ構成の場合の起動と停止

ここでは，通信サーバfor Billerをクラスタ構成で構築している場合の起動/停止方法について説明します。

＜この項の構成＞

(1)　起動/停止の流れ

(2)　強制起動/強制停止

(1)　起動/停止の流れ

クラスタ構成の場合，複数のサーバでの運用になりますが，起動/停止方法は通常の操作方法と同様です。次のように起動/停止します。

図8-2　クラスタ構成の場合の起動と停止の流れ（手動起動の場合）

サーバの数が増えても，この流れに変更はありません。この図での前提条件を次に示します。

通信サーバシステム定義の「BL_AUTO_START」に「MANUAL」を指定して，手動で起動する

通信サーバAで通信サーバfor Billerの開閉局処理をする

クラスタ構成の場合，複数のサーバで運用しますが，通信サーバfor Billerの開局および閉局処理は，どれか一つのサーバが一回だけ行います。通信サーバfor Billerの開局処理と閉局処理を，それぞれ異なるサーバでも実行できます。

システムの起動およびシステムの停止での注意事項については，「8.2.1　システムを起動/停止する前に」を参照してください。

クラスタ構成の場合，起動/停止方法は通常の操作方法と同様ですが，強制起動および強制停止には注意が必要です。強制起動および強制停止については，「(2)　強制起動/強制停止」を参照してください。

(2)　強制起動/強制停止

強制起動，および強制停止する際は次のことに注意してください。

(a)　強制起動

クラスタ構成での強制起動方法は通常の操作方法と同様ですが，強制起動後の通信サーバfor Billerの開閉局状態が一部異なります。ここでは，クラスタ構成で障害停止した場合の強制起動後の通信サーバfor Billerの開閉局状態について説明します。

停止時の通信サーバfor Billerの開閉局状態を引き継がないで起動したい場合

強制起動方法は，通常の操作方法と同様です。オプションに「-F」を指定します。収納機関サービスの自動起動定義（AUTO_START）に従って起動したあと，障害停止時の通信サーバfor Billerの開閉局状態に関係なく，自動開局定義（AUTO_OPEN）によって開閉局処理をします。しかし，クラスタ構成では，開局中または開局処理中に障害停止し，ほかの通信サーバが起動しているときだけ，自動開局定義が「MANUAL」でも開局中になります。

このオプションで強制起動したあとの通信サーバfor Billerの開閉局状態を次に示します。

表8-3　強制起動後の通信サーバfor Billerの開閉局状態（クラスタ構成での-Fの場合）

障害停止時 | 強制起動後
開閉局状態 | ほかの通信サーバの起動/停止状態 | 自動開局定義（AUTO_OPEN） | 開閉局状態
開局中 | 起動中 | MANUAL | 開局中
AUTO
停止中 | MANUAL | 閉局中
AUTO | 開局中※
開局処理中 | 起動中 | MANUAL | 開局中
AUTO
停止中 | MANUAL | 閉局中
AUTO | 開局中※
閉局処理中 | 起動中 | MANUAL | 閉局中
AUTO
停止中 | MANUAL | 閉局中
AUTO | 開局中※
閉局中 | 起動中 | MANUAL | 閉局中
AUTO | 開局中
停止中 | MANUAL | 閉局中
AUTO | 開局中※

注※

共通ソフトウェアのすべてのチャネルがRUNNINGの場合だけ，開局中になります。

停止時の収納機関サービスの状態および通信サーバfor Billerの開閉局状態を引き継いで起動したい場合

強制起動方法は，通常の操作方法と同様です。オプションに「-R」を指定します。

また，このオプションの場合，自動開局定義に関係なく，通信サーバfor Billerの送受信チャネルの状態が一つでもRUNNINGであれば，開局処理をします。このオプションで強制起動したあとの通信サーバfor Billerの開閉局状態は，通常と同様です。しかし，クラスタ構成では，障害停止時の通信サーバfor Billerの開閉局状態が開局処理中または閉局処理中のときだけ，ほかの通信サーバが起動していると，障害停止時の通信サーバfor Billerの開閉局状態を引き継がず，強制起動するときの開閉局状態に従います。オプションに「-R」を指定した場合の通信サーバfor Billerの開閉局状態については，「8.2.2(2)　コマンドによる手動起動」を参照してください。

通常の強制起動については，「8.2.2　通信サーバfor Billerの起動」を参照してください。また，通信サーバfor Billerの起動コマンド（hmpnstart）の詳細については，「10.3　コマンドの詳細　hmpnstart（通信サーバfor Billerの起動）」を参照してください。

(b)　強制停止

クラスタ構成での強制停止方法は，通常の操作方法と同様です。

また，通信サーバfor Billerの開閉局状態に関係なく，一部の通信サーバを停止させクラスタ構成から切り離す場合は，通信サーバfor Billerの停止コマンド（hmpnstop）のオプションに「-C」を指定してください。ただし，クラスタ構成での運用中に，最後に停止させる通信サーバに対して「-C」オプションは指定しないでください。

通常の強制停止については，「8.2.7　通信サーバfor Billerの停止」を参照してください。また，通信サーバfor Billerの停止コマンドの詳細については，「10.3　コマンドの詳細　hmpnstop（通信サーバfor Billerの停止）」を参照してください。

8.3　システムの管理

通信サーバfor Billerの起動状態および開閉局状態などの表示方法，収納カウンタ情報の取得方法，ファイル初期化について説明します。これらの手順は，必要に応じて実行してください。

＜この節の構成＞

8.3.1　状態表示

8.3.2　収納カウンタ情報取得

8.3.3　ファイル初期化

8.3.1　状態表示

状態表示とは，通信サーバfor Billerの構成の種類，起動状態，開閉局状態および各収納機関の収納機関サービスの状態を表示する操作です。これらの状態を表示するには，状態表示コマンド（hmpnstat）を実行してください。

状態表示コマンドにオプションを指定して実行すると，指定した収納機関の収納機関サービスの状態が表示されます。状態表示コマンドの詳細については，「10.3　コマンドの詳細　hmpnstat（状態表示）」を参照してください。

8.3.2　収納カウンタ情報取得

収納カウンタ情報取得とは，MPNセンタが保有している収納カウンタ情報をオンラインで取得する操作です。収納カウンタ情報には，通信サーバfor BillerとMPNセンタとの間の収納情報の集計値が含まれており，オンライン取引の精査に利用できます。

収納カウンタ情報の取得には，次の方法があります。

自動取得

コマンドによる手動取得

自動取得の場合は，閉局時に収納カウンタ情報が自動で取得されます。手動での取得の場合，コマンドを実行して手動で取得してください。

また，収納カウンタ情報を取得したあとに通信サーバfor Billerを閉局するときには，収納カウンタ情報の取得に成功したことを確認してください。

＜この項の構成＞

(1)　自動取得

(2)　コマンドによる手動取得

(1)　自動取得

通信サーバfor Billerの閉局時に，MPNセンタからカウンタ通知電文を自動で受信します。受信したカウンタ通知電文には，当日分と前日分の収納カウンタ情報が含まれています。取得した収納カウンタ情報は，DBに保存されます。収納カウンタ情報を格納する形式については，「5.3　収納カウンタ情報格納用テーブルの作成」を参照してください。

注意

収納カウンタ情報を自動取得する場合は，JAMMOにMPNセンタ管理情報を申請するときに，サーバ情報の「カウンタ通知要否」項目を「要」にしてください。

(2)　コマンドによる手動取得

収納カウンタ情報取得コマンド（hmpncntget）を実行してください。ただし，コマンドは，通信サーバfor Billerの開閉局状態が「開局中」のときだけ実行できます。なお，クラスタ構成の場合，一つの通信サーバで実行してください。

収納カウンタ情報取得コマンドにオプションを指定して実行すると，収納カウンタ情報が標準出力に表示されます。なお，取得できる収納カウンタ情報は，コマンド実行日の当日，前日および前々日だけです。

収納カウンタ情報取得コマンドの詳細については，「10.3　コマンドの詳細　hmpncntget（収納カウンタ情報取得）」を参照してください。

8.3.3　ファイル初期化

通信サーバfor Billerの動作に必要な初期化処理をするために，ファイル初期化コマンド（hmpnblinit）を実行する必要があります。通信サーバシステム定義を作成または編集した場合は，必ずファイル初期化を行ってください。

ファイル初期化を行う前に，ロウ論理ボリュームを作成しておく必要があります。ロウ論理ボリュームの作成については，「3.4.5　ロウ論理ボリュームの作成」を参照してください。

ファイル初期化コマンドの詳細については，「10.3　コマンドの詳細　hmpnblinit（ファイル初期化）」を参照してください。

8.4　DBバッチ処理の運用

通信サーバfor Billerで運用できるDBバッチ処理は，納付情報の一括登録，請求情報の一括登録，消込情報ファイルの変換，一括消込，消込情報の出力，金融機関情報の変更，および収納機関情報の変更です。

DBバッチ処理は，コマンドで実行します。なお，収納サービスの種類によって，運用できるDBバッチ処理が異なります。収納サービスごとのコマンドの実行可否については，「10.2　コマンド一覧」を参照してください。

ここでは，DBバッチ処理の運用手順と，各DBバッチ処理の詳細について説明します。

＜この節の構成＞

8.4.1　DBバッチ処理の運用手順

8.4.2　納付情報の一括登録

8.4.3　請求情報の一括登録

8.4.4　消込情報ファイルの変換

8.4.5　一括消込

8.4.6　消込情報の出力

8.4.7　金融機関情報の変更

8.4.8　収納機関情報の変更

8.4.1　DBバッチ処理の運用手順

通信サーバfor BillerのDBとして，HiRDB/Single Serverを使用している場合，HiRDB/Parallel Serverを使用している場合のDBバッチ処理の運用手順について，それぞれ説明します。なお，DBバッチ処理の詳細については次項以降を，コマンドの詳細については「10.3　コマンドの詳細」を参照してください。

＜この項の構成＞

(1)　HiRDB/Single ServerでのDBバッチ処理の運用手順

(2)　HiRDB/Parallel ServerでのDBバッチ処理の運用手順

(1)　HiRDB/Single ServerでのDBバッチ処理の運用手順

HiRDB/Single Serverを使用している場合は，DBバッチ処理に応じてコマンドを実行します。DBバッチ処理の詳細，および実行するコマンドについては，次項以降を参照してください。

一括消込とほかの機能では，運用手順が異なります。それぞれの運用手順について説明します。

一括消込の運用手順
一括消込の運用手順を次に示します。

図8-3　一括消込の運用手順（HiRDB/Single Serverの場合）

MPNセンタから伝送ファイルを受信する

伝送ファイルを消込情報ファイルに変換する
消込情報ファイルの変換コマンド（hmpnpayfile）を実行し，伝送ファイルを消込情報ファイルに変換します。

一括消込する
一括消込コマンド（hmpnpayload）を実行し，消込情報をDBへ一括登録します。消込情報の一括登録が終了すると，消込情報に対する納付情報または請求情報も更新されます。

一括消込以外の機能の運用手順
納付情報の一括登録，請求情報の一括登録，消込情報の出力，金融機関情報の変更，および収納機関情報の変更の運用手順について説明します。
ここでは，例として，納付情報の一括登録の運用手順について説明します。ほかの機能の運用手順については，コマンド名，ファイル名，およびDB名を読み替えてください。
納付情報の一括登録の運用手順を次に示します。

図8-4　納付情報の一括登録の運用手順（HiRDB/Single Serverの場合）

一括登録する
納付情報の一括登録コマンド（hmpnbilload）を実行し，納付情報をDBへ一括登録します。

(2)　HiRDB/Parallel ServerでのDBバッチ処理の運用手順

HiRDB/Parallel Serverを使用している場合に，次に示すDBバッチ処理を運用するときは，HiRDB/Parallel Serverのシステム構成に合わせた運用が必要になります。

納付情報の一括登録

請求情報の一括登録

一括消込

金融機関情報の変更

収納機関情報の変更

HiRDB/Parallel Serverでは，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が同じユニットにあるか，別のユニットにあるかによって，DBバッチ処理の運用手順が異なります。HiRDB/Parallel Serverのシステム構成ごとに，DBバッチ処理の運用手順について説明します。

なお，ほかの機能の場合は，HiRDB/Parallel Serverのシステム構成に合わせた運用は必要ありません。システムマネジャのあるサーバ，または実行サーバのあるサーバで，DBバッチ処理を実行してください。

(a)　システムマネジャとフロントエンドサーバが同じユニットにある場合

実行サーバがフロントエンドサーバで，システムマネジャと同じユニットにある場合は，次のように運用してください。

DBバッチ処理のコマンドの入力情報ファイルは，システムマネジャがあるサーバに作成する。

次の操作を実行する前に，システムマネジャがあるサーバでコマンドを実行し，入力情報ファイルをチェックする。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

次の操作の場合は，システムマネジャがあるサーバでコマンドを実行する。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

ただし，次の操作の場合は，システムマネジャがないサーバでコマンドを実行してもよい。

金融機関情報または収納機関情報の削除

一括消込とほかの機能では，運用手順が異なります。それぞれの運用手順について説明します。

一括消込の運用手順
システムマネジャとフロントエンドサーバが同じユニットにある場合の，一括消込の運用手順を次に示します。なお，ここでは，サーバAにあるフロントエンドサーバ（FES）が実行サーバになります。

図8-5　一括消込の運用手順（HiRDB/Parallel Server：システムマネジャとフロントエンドサーバが同じユニットにある場合）

MPNセンタから伝送ファイルを受信する

伝送ファイルを消込情報ファイルに変換する
伝送ファイルを受信したサーバAで，消込情報ファイルの変換コマンド（hmpnpayfile）を実行し，伝送ファイルを消込情報ファイルに変換します。

消込情報ファイルをチェックする
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-c」を指定して実行し，消込情報ファイルが正しく作成されているかどうかをチェックします。

一括消込する
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-nc」を指定して実行し，消込情報をDBへ一括登録します。消込情報の一括登録が終了すると，消込情報に対する納付情報または請求情報も更新されます。

一括消込以外の機能の運用手順
納付情報の一括登録，請求情報の一括登録，金融機関情報の変更，および収納機関情報の変更の運用手順について説明します。
ここでは，例として，納付情報の一括登録の運用手順について説明します。ほかの機能の運用手順については，コマンド名，ファイル名，およびDB名を読み替えてください。
システムマネジャとフロントエンドサーバが同じユニットにある場合の，納付情報の一括登録の運用手順を次に示します。なお，ここでは，サーバAにあるフロントエンドサーバ（FES）が実行サーバになります。

図8-6　納付情報の一括登録の運用手順（HiRDB/Parallel Server：システムマネジャとフロントエンドサーバが同じユニットにある場合）

納付情報ファイルをチェックする
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-c」を指定して実行し，納付情報ファイルが正しく作成されているかどうかをチェックします。

一括登録する
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-nc」を指定して実行し，納付情報をDBへ一括登録します。

(b)　システムマネジャとフロントエンドサーバが別のユニットにある場合

実行サーバがフロントエンドサーバで，システムマネジャと別のユニットにある場合は，次のように運用してください。

DBバッチ処理のコマンドの入力情報ファイルは，実行サーバ（フロントエンドサーバ）があるサーバに作成する。ただし，MPNセンタから受信した伝送ファイルは，受信したサーバで消込情報ファイルに変換し，実行サーバ（フロントエンドサーバ）があるサーバへファイル転送する。

次の操作を実行する前に，実行サーバ（フロントエンドサーバ）があるサーバでコマンドを実行し，入力情報ファイルをチェックする。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

次の操作の場合は，システムマネジャがあるサーバでコマンドを実行する。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

ただし，次の操作の場合は，システムマネジャがないサーバでコマンドを実行してもよい。

金融機関情報または収納機関情報の削除

一括消込とほかの機能では，運用手順が異なります。それぞれの運用手順について説明します。

一括消込の運用手順
システムマネジャとフロントエンドサーバが別のユニットにある場合の，一括消込の運用手順を次に示します。なお，ここでは，サーバBにあるフロントエンドサーバ（FES）が実行サーバになります。

図8-7　一括消込の運用手順（HiRDB/Parallel Server：システムマネジャとフロントエンドサーバが別のユニットにある場合）

MPNセンタから伝送ファイルを受信する

伝送ファイルを消込情報ファイルに変換する
伝送ファイルを受信したサーバAで，消込情報ファイルの変換コマンド（hmpnpayfile）を実行し，伝送ファイルを消込情報ファイルに変換します。

消込情報ファイルを転送する
サーバAから実行サーバ（フロントエンドサーバ）があるサーバBに，FTPを使用してASCIIモードで消込情報ファイルを転送します。このとき，転送元と同じディレクトリ配下に転送します。

消込情報ファイルをチェックする
実行サーバ（フロントエンドサーバ）があるサーバBで，一括消込コマンド（hmpnpayload）のオプションに「-c」を指定して実行し，消込情報ファイルが正しく作成されているかどうかをチェックします。

一括消込する
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-nc -st セットアップディレクトリ」を指定して実行し，消込情報をDBへ一括登録します。消込情報の一括登録が終了すると，消込情報に対する納付情報または請求情報も更新されます。

一括消込以外の機能の運用手順
納付情報の一括登録，請求情報の一括登録，金融機関情報の変更，および収納機関情報の変更の運用手順について説明します。
ここでは，例として，納付情報の一括登録の運用手順について説明します。ほかの機能の運用手順については，コマンド名，ファイル名，およびDB名を読み替えてください。
システムマネジャとフロントエンドサーバが別のユニットにある場合の，納付情報の一括登録の運用手順を次に示します。なお，ここでは，サーバBにあるフロントエンドサーバ（FES）が実行サーバになります。

図8-8　納付情報の一括登録の運用手順（HiRDB/Parallel Server：システムマネジャとフロントエンドサーバが別のユニットにある場合）

納付情報ファイルをチェックする
実行サーバ（フロントエンドサーバ）があるサーバBで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-c」を指定して実行し，納付情報ファイルが正しく作成されているかどうかをチェックします。

一括登録する
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-nc -st セットアップディレクトリ」を指定して実行し，納付情報をDBへ一括登録します。

(c)　システムマネジャとバックエンドサーバが同じユニットにある場合

実行サーバがバックエンドサーバで，システムマネジャと同じユニットにある場合は，次のように運用してください。

DBバッチ処理のコマンドの入力情報ファイルは，システムマネジャがあるサーバに作成する。

次の操作を実行する前に，システムマネジャがあるサーバでコマンドを実行し，入力情報ファイルをチェックする。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

次の操作の場合は，システムマネジャがあるサーバでコマンドを実行する。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

ただし，次の操作の場合は，システムマネジャがないサーバでコマンドを実行してもよい。

金融機関情報または収納機関情報の削除

一括消込とほかの機能では，運用手順が異なります。それぞれの運用手順について説明します。

一括消込の運用手順
システムマネジャとバックエンドサーバが同じユニットにある場合の，一括消込の運用手順を次に示します。なお，ここでは，サーバAにあるバックエンドサーバ（BES）が実行サーバになります。

図8-9　一括消込の運用手順（HiRDB/Parallel Server：システムマネジャとバックエンドサーバが同じユニットにある場合）

MPNセンタから伝送ファイルを受信する

伝送ファイルを消込情報ファイルに変換する
伝送ファイルを受信したサーバAで，消込情報ファイルの変換コマンド（hmpnpayfile）を実行し，伝送ファイルを消込情報ファイルに変換します。

消込情報ファイルをチェックする
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-c」を指定して実行し，消込情報ファイルが正しく作成されているかどうかをチェックします。

一括消込する
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-nc」を指定して実行し，消込情報をDBへ一括登録します。消込情報の一括登録が終了すると，消込情報に対する納付情報または請求情報も更新されます。

一括消込以外の機能の運用手順
納付情報の一括登録，請求情報の一括登録，金融機関情報の変更，および収納機関情報の変更の運用手順について説明します。
ここでは，例として，納付情報の一括登録の運用手順について説明します。ほかの機能の運用手順については，コマンド名，ファイル名，およびDB名を読み替えてください。
システムマネジャとバックエンドサーバが同じユニットにある場合の，納付情報の一括登録の運用手順を次に示します。なお，ここでは，サーバAにあるバックエンドサーバ（BES）が実行サーバになります。

図8-10　納付情報の一括登録の運用手順（HiRDB/Parallel Server：システムマネジャとバックエンドサーバが同じユニットにある場合）

納付情報ファイルをチェックする
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-c」を指定して実行し，納付情報ファイルが正しく作成されているかどうかをチェックします。

一括登録する
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-nc」を指定して実行し，納付情報をDBへ一括登録します。

(d)　システムマネジャとバックエンドサーバが別のユニットにある場合

実行サーバがバックエンドサーバで，システムマネジャと別のユニットにある場合は，次のように運用してください。

DBバッチ処理のコマンドの入力情報ファイルは，実行サーバ（バックエンドサーバ）があるサーバに作成する。ただし，MPNセンタから受信した伝送ファイルは，受信したサーバで消込情報ファイルに変換し，実行サーバ（バックエンドサーバ）があるサーバへファイル転送する。

次の操作を実行する前に，実行サーバ（バックエンドサーバ）があるサーバでコマンドを実行し，入力情報ファイルをチェックする。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

次の操作の場合は，システムマネジャがあるサーバでコマンドを実行する。

納付情報または請求情報の一括登録

一括消込

金融機関情報または収納機関情報の追加登録

ただし，次の操作の場合は，システムマネジャがないサーバでコマンドを実行してもよい。

金融機関情報または収納機関情報の削除

一括消込とほかの機能では，運用手順が異なります。それぞれの運用手順について説明します。

一括消込の運用手順
システムマネジャとバックエンドサーバが別のユニットにある場合の，一括消込の運用手順を次に示します。なお，ここでは，サーバBにあるバックエンドサーバ（BES）が実行サーバになります。

図8-11　一括消込の運用手順（HiRDB/Parallel Server：システムマネジャとバックエンドサーバが別のユニットにある場合）

MPNセンタから伝送ファイルを受信する

伝送ファイルを消込情報ファイルに変換する
伝送ファイルを受信したサーバAで，消込情報ファイルの変換コマンド（hmpnpayfile）を実行し，伝送ファイルを消込情報ファイルに変換します。

消込情報ファイルを転送する
サーバAから実行サーバ（バックエンドサーバ）があるサーバBに，FTPを使用してASCIIモードで消込情報ファイルを転送します。このとき，転送元と同じディレクトリ配下に転送します。

消込情報ファイルをチェックする
実行サーバ（バックエンドサーバ）があるサーバBで，一括消込コマンド（hmpnpayload）のオプションに「-c」を指定して実行し，消込情報ファイルが正しく作成されているかどうかをチェックします。

一括消込する
システムマネジャがあるサーバAで，一括消込コマンド（hmpnpayload）のオプションに「-nc -st セットアップディレクトリ」を指定して実行し，消込情報をDBへ一括登録します。消込情報の一括登録が終了すると，消込情報に対する納付情報または請求情報も更新されます。

一括消込以外の機能の運用手順
納付情報の一括登録，請求情報の一括登録，金融機関情報の変更，および収納機関情報の変更の運用手順について説明します。
ここでは，例として，納付情報の一括登録の運用手順について説明します。ほかの機能の運用手順については，コマンド名，ファイル名，およびDB名を読み替えてください。
システムマネジャとバックエンドサーバが別のユニットにある場合の，納付情報の一括登録の運用手順を次に示します。なお，ここでは，サーバBにあるバックエンドサーバ（BES）が実行サーバになります。

図8-12　納付情報の一括登録の運用手順（HiRDB/Parallel Server：システムマネジャとバックエンドサーバが別のユニットにある場合）

納付情報ファイルをチェックする
実行サーバ（バックエンドサーバ）があるサーバBで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-c」を指定して実行し，納付情報ファイルが正しく作成されているかどうかをチェックします。

一括登録する
システムマネジャがあるサーバAで，納付情報の一括登録コマンド（hmpnbilload）のオプションに「-nc -st セットアップディレクトリ」を指定して実行し，納付情報をDBへ一括登録します。

8.4.2　納付情報の一括登録

納付情報の一括登録とは，複数の納付情報をDBへ一括登録する操作です。収納機関コードごとに実行できます。

また，納付情報の一括登録コマンド（hmpnbilload）のオプションを指定すると，次の機能が追加されます。入力情報ファイルは，規則に従い前もって作成しておく必要があります。

入力情報ファイルのチェックだけを実行する
入力情報ファイルは，納付情報を記述したファイルです。この機能を利用すると，納付情報の一括登録はしないで，入力情報ファイルが正しく作成されているかどうかをチェックできます。

エラーメッセージの出力件数を指定する
入力情報ファイルのチェック時に検出した，レコード誤りを，指定した件数だけ表示するための機能です。

結果報告ファイルを出力する
入力情報ファイルをチェックした結果，および入力情報ファイルをDBに登録した結果を，結果報告ファイルとして出力する機能です。
結果報告ファイルに出力される内容を次に示します。

表8-4　結果報告ファイルに出力される内容（納付情報の一括登録）

結果報告ファイルの種類 | ファイルに出力される内容
データチェックファイル | 入力情報ファイルのデータをチェックしたときに，検知した誤りを出力します。
データ登録ファイル | 納付情報を編集し，DBに登録したときの登録データを出力します。

納付情報の一括登録をオンラインで実行する
納付情報の一括登録は，オフラインでの実行を推奨しています。しかし，このオプションを指定すると，納付情報の一括登録がオンラインで実行できます。ただし，オンラインで実行すると，一定時間DBを占有するため，オンライン性能に影響が出ます。

納付情報の一括登録コマンドの詳細については，「10.3　コマンドの詳細　hmpnbilload（納付情報の一括登録）」を参照してください。

8.4.3　請求情報の一括登録

請求情報の一括登録とは，複数の請求情報をDBへ一括登録する操作です。収納機関コードごとに実行できます。

また，請求情報の一括登録コマンド（hmpndemload）のオプションを指定すると，次の機能が追加されます。入力情報ファイルは，規則に従い前もって作成しておく必要があります。

入力情報ファイルのチェックだけを実行する
入力情報ファイルは，請求情報を記述したファイルです。この機能を利用すると，請求情報の一括登録はしないで，入力情報ファイルが正しく作成されているかどうかをチェックできます。

エラーメッセージの出力件数を指定する
入力情報ファイルのチェック時に検出した，レコード誤りを，指定した件数だけ表示するための機能です。

結果報告ファイルを出力する
入力情報ファイルをチェックした結果，および入力情報ファイルをDBに登録した結果を，結果報告ファイルとして出力する機能です。
結果報告ファイルに出力される内容を次に示します。

表8-5　結果報告ファイルに出力される内容（請求情報の一括登録）

結果報告ファイルの種類 | ファイルに出力される内容
データチェックファイル | 入力情報ファイルのデータをチェックしたときに，検知した誤りを出力します。
データ登録ファイル | 請求情報を編集し，DBに登録したときの登録データを出力します。

請求情報の一括登録をオンラインで実行する
請求情報の一括登録は，オフラインでの実行を推奨しています。しかし，このオプションを指定すると，請求情報の一括登録がオンラインで実行できます。ただし，オンラインで実行すると，一定時間DBを占有するため，オンライン性能に影響が出ます。
請求情報の一括登録コマンドの詳細については，「10.3　コマンドの詳細　hmpndemload（請求情報の一括登録）」を参照してください。

8.4.4　消込情報ファイルの変換

消込情報ファイルの変換とは，伝送ファイルを消込情報ファイルに変換する操作です。伝送ファイルは，MPNセンタからファイル転送によって，通信サーバfor Billerに送られます。収納機関コードごとに実行できます。

消込情報ファイルの変換では，次に示すチェック機能があります。

伝送ファイルのフォーマットチェック
伝送ファイルのMPNヘッダー部，ヘッダーレコードなどの内容をチェックします。

対象金融機関チェック
伝送ファイル内の項目についてDBの対象金融機関情報格納用テーブルの内容と一致しているかどうかをチェックしています。対象金融機関チェックのチェック項目を次に示します。

表8-6　対象金融機関チェックのチェック項目

伝送ファイルの項目 | DBのテーブルの項目
ヘッダーレコードの「金融機関コード」 | 「金融機関コード」
データレコードの「金融機関店舗コード」 | 「店舗コード」
データレコードの「チャネル区分」 | 「チャネル区分」
データレコードの「収納識別情報」にある「税目・料金番号」※ | 「納付区分」※

注※

この項目は，地方税・地公体料金の場合だけチェックします。

伝送ファイルのフォーマットチェック，および対象金融機関チェックでエラーメッセージが出力されます。対象金融機関チェックでエラーとなった場合は，消込情報ファイルのリターン情報に，仮消込情報としてリターンコードを設定します。設定するリターンコードと，各リターンコードの説明を次に示します。

表8-7　仮消込情報として設定するリターンコード（消込情報ファイルの変換）

リターンコード
説明

HMPNA002※1

金融機関コード，または店舗コードがDBの対象金融機関情報格納用テーブルに登録されているものと不一致の場合

税目・料金番号※2，金融機関コード，店舗コード，およびチャネル区分は一致しているが，適用年月日は範囲外の場合

HMPNA010※1
税目・料金番号※2，金融機関コード，および店舗コードは一致しているが，チャネル区分が不一致の場合

HMPNA013※1
金融機関コード，および店舗コードは一致しているが，税目・料金番号※2は不一致の場合

注※1

対象金融機関チェックでエラーの場合に設定しますが，正常に処理します。

注※2

税目・料金番号は，地方税・地公体料金の場合だけ設定しています。一般料金で税目・料金番号を設定していた場合，チェック範囲外となります。

消込情報ファイルの変換コマンド（hmpnpayfile）のオプションを指定すると，次の機能が追加されます。

エラーメッセージの出力件数を指定する機能

MPNセンタから媒体で受け取った伝送ファイルをファイル変換する機能

消込情報ファイルの変換コマンドの詳細については，「10.3　コマンドの詳細　hmpnpayfile（消込情報ファイルの変換）」を参照してください。

8.4.5　一括消込

一括消込とは，複数の消込情報をDBへ一括登録する操作です。収納機関コードごとに実行できます。

また，一括消込コマンド（hmpnpayload）のオプションを指定すると，次の機能が追加されます。

入力情報ファイルのチェックだけを実行する
入力情報ファイルは，消込情報を記述したファイルです。入力情報ファイルは，消込情報ファイルの変換コマンド（hmpnpayfile）の実行などによって，用意されていることを前提とします。この機能を利用すると，一括消込しないで，入力情報ファイルが正しく作成されているかどうかをチェックできます。

エラーメッセージの出力件数を指定する
入力情報ファイルのチェック時に検出した，レコード誤りを，指定した件数だけ表示するための機能です。

結果報告ファイルを出力する
入力情報ファイルをチェックした結果，および入力情報ファイルをDBに登録した結果を，結果報告ファイルとして出力する機能です。結果報告ファイルに出力される内容を次に示します。

表8-8　結果報告ファイルに出力される内容（一括消込）

結果報告ファイルの種類 | ファイルに出力される内容
データチェックファイル | 入力情報ファイルのデータをチェックしたときに，検知した誤りを出力します。
データ登録ファイル | 消込情報を編集し，DBに登録したときの登録データを出力します。

一括消込をオンラインで実行する
一括消込は，オフラインでの実行を推奨しています。しかし，このオプションを指定すると，一括消込がオンラインで実行できます。ただし，オンラインで実行すると，一定時間DBを占有するため，オンライン性能に影響が出ます。
消込情報をDBに登録し，DBに該当する納付情報，または請求情報がない場合は，消込カウンタを更新しないため，DBの消込情報中のリターン情報に（HMPNA303）を設定し一括消込コマンドを続行します。また，消込情報のリターン情報に（HMPNA002），（HMPNA010），または（HMPNA013）が設定されている場合，消込カウンタは更新しません。
消込カウンタの更新を行えない場合は，次に示す形式の結果報告ファイルを出力します。

地方税・地公体料金の場合

（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/bat/pay/（納付情報格納用テーブル名）_yyyymmdd_hhmmss

一般料金の場合

（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/bat/pay/（請求情報格納用テーブル名）_yyyymmdd_hhmmss

（凡例）

yyyy：年

mm：月

dd：日

hh：時

mm：分

ss：秒

一括消込コマンドの詳細については，「10.3　コマンドの詳細　hmpnpayload（一括消込）」を参照してください。

8.4.6　消込情報の出力

消込情報の出力とは，収納機関コードおよび取扱日を入力し，該当する消込情報レコードをファイルとして出力する操作です。通信サーバfor Billerは，取扱日をキーにして，チャネル区分がオンライン方式の仕向処理年月日に該当する消込情報レコードをDBから検索します。この操作は，収納機関コードごとに実行できます。

消込情報の出力コマンド（hmpnpaylist）のオプションを指定すると，検索する取扱日の対象を，オンライン方式の仕向処理年月日から，一括伝送方式のMPN処理年月日に変更できます。オンライン方式，および一括伝送方式は，MPNの仕様に従っています。

消込情報の出力コマンドの詳細については，「10.3　コマンドの詳細　hmpnpaylist（消込情報の出力）」を参照してください。

8.4.7　金融機関情報の変更

金融機関情報の変更とは，金融機関情報をDBへ追加登録，またはDBの金融機関情報を削除する操作です。金融機関情報を削除する場合，収納機関コードごとに削除します。

また，金融機関情報の変更コマンド（hmpnbnkctl）のオプションを指定すると，次の機能が追加されます。入力情報ファイルは，規則に従い前もって作成しておく必要があります。

入力情報ファイルのチェックだけを実行する
入力情報ファイルは，金融機関情報を記述したファイルです。この機能を利用すると，金融機関情報を変更しないで，入力情報ファイルが正しく作成されているかどうかをチェックできます。

エラーメッセージの出力件数を指定する
入力情報ファイルのチェック時に検出した，レコード誤りを，指定した件数だけ表示するための機能です。

結果報告ファイルを出力する
入力情報ファイルをチェックした結果，および入力情報ファイルをDBに登録した結果を，結果報告ファイルとして出力する機能です。
結果報告ファイルに出力される内容を次に示します。

表8-9　結果報告ファイルに出力される内容（金融機関情報の変更）

結果報告ファイルの種類 | ファイルに出力される内容
データチェックファイル | 入力情報ファイルのデータをチェックしたときに，検知した誤りを出力します。
データ登録ファイル | 金融機関情報を編集し，DBに登録したときの登録データを出力します。

金融機関情報の変更コマンドの詳細については，「10.3　コマンドの詳細　hmpnbnkctl（金融機関情報の変更）」を参照してください。

8.4.8　収納機関情報の変更

収納機関情報の変更とは，収納機関情報をDBへ追加登録，または対象収納機関の収納機関情報を削除する操作です。

また，収納機関情報の変更コマンド（hmpnrcvctl）のオプションを指定すると，次の機能が追加されます。入力情報ファイルは，規則に従い前もって作成しておく必要があります。

入力情報ファイルのチェックだけを実行する
入力情報ファイルは，収納機関情報を記述したファイルです。この機能を利用すると，収納機関情報を変更しないで，入力情報ファイルが正しく作成されているかどうかをチェックできます。

結果報告ファイルを出力する
入力情報ファイルをチェックした結果，および入力情報ファイルをDBに登録した結果を，結果報告ファイルとして出力する機能です。
結果報告ファイルに出力される内容を次に示します。

表8-10　結果報告ファイルに出力される内容（収納機関情報の変更）

結果報告ファイルの種類 | ファイルに出力される内容
データチェックファイル | 入力情報ファイルのデータをチェックしたときに，検知した誤りを出力します。
データ登録ファイル | 収納機関情報を編集し，DBに登録したときの登録データを出力します。
データ削除ファイル | 対象収納機関情報格納用テーブルから削除したデータを出力します。

収納機関情報の変更コマンドの詳細については，「10.3　コマンドの詳細　hmpnrcvctl（収納機関情報の変更）」を参照してください。

9.　障害時の運用

この章では，障害時に取得する情報，障害時の対応方法などについて説明します。

＜この章の構成＞

9.1　障害情報の取得

9.2　通信サーバfor Billerの障害対策

9.1　障害情報の取得

通信サーバfor Billerに障害が発生した場合は，障害情報を取得して，障害の原因を調査できます。

障害情報は，ファイルやテーブルに出力されています。通信サーバfor Billerに障害が発生した場合は，これらのファイルやテーブルを取得して，障害の原因を調査してください。また，必要に応じて，環境変数の設定内容をファイルに取得してください。

＜この節の構成＞

9.1.1　ファイルに出力される障害情報

9.1.2　環境変数の設定内容

9.1.3　DBのテーブルに出力される障害情報

9.1.1　ファイルに出力される障害情報

障害時に取得するファイル，およびプロセス起動時に生成されるファイルについて説明します。

＜この項の構成＞

(1)　障害発生時に取得するファイル

(2)　プロセス起動時に生成されるファイル

(1)　障害発生時に取得するファイル

障害発生時に取得するファイルについて説明します。

なお，HiRDB/Parallel Serverを使用する場合，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）を別のマシンにセットアップするときは，次の点に注意してください。

エラー情報ファイルや結果報告ファイルは，実行サーバ上のセットアップディレクトリ下に出力されます。

一括登録を実施した場合，エラーメッセージが実行サーバ上に出力されることがあります。この場合，実行サーバ上のsyslogを参照し，原因を特定してください。

障害発生時は，次のファイルを取得してください。

表9-1　障害発生時に取得するファイル

障害情報
取得するファイル

通信サーバfor Billerの障害情報
AIX 5LまたはHP-UXのsyslog

統合トレースファイル
/opt/hitachi/HNTRLib/spool/hntr[n].log

通信サーバ運用・制御情報
（通信サーバfor Billerセットアップディレクトリ）/work/※1

プロセス起動時に生成されるファイル
（通信サーバfor Billerセットアップディレクトリ）/spool/※2

バッチ処理コマンド実行障害時に生成されるファイル
（通信サーバfor Billerセットアップディレクトリ）/spool/bl/bat/（err/エラー情報ファイル, idx/インデクス情報ファイル, pay/エラー情報ファイル）

共通ソフトウェア情報
共通ソフトウェアログファイル※3

通信制御モジュールのログファイル※4

共通ソフトウェアの環境設定ファイル（オンライン電文用）※5

OpenTP1の障害情報
（OpenTP1トレースファイル作成ディレクトリ）/（OpenTP1トレースファイル，およびコアファイル）

（OpenTP1セットアップディレクトリ）/spool/※6

HiRDBの障害情報
（HiRDBセットアップディレクトリ）/spool/※7

障害解析用情報
（OpenTP1定義ファイル格納ディレクトリ）/（OpenTP1定義ファイル）

通信サーバシステム定義ファイル
（通信サーバfor Billerセットアップディレクトリ）/conf/HMpnSvConf

コマンド異常終了時にカレントディレクトリに出力されるコアダンプ

注※1

このディレクトリ下のファイルはリンクファイルです。そのため，ファイルを保存する時には，リンク先のファイルを保存する必要があります。ファイルの保存後は，必ず次のコマンドを実行し，リンク先ファイルが保存されていることを確認してください。確認したファイル名にリンク記号「＠」がない場合は，実際のファイルが保存されています。

# ls -lF

注※2

プロセス起動時に生成されるファイルについては，「(2)　プロセス起動時に生成されるファイル」を参照してください。

注※3

共通ソフトウェアの環境設定ファイル（オンライン電文用）で，共通ソフトウェアログファイルの出力先を指定できます。

注※4

通信制御モジュールのログファイルの出力先は，共通ソフトウェアの購入元に確認してください。

注※5

共通ソフトウェアの環境設定ファイル（オンライン電文用）が格納されているディレクトリは，共通ソフトウェアの購入元に確認してください。

注※6

OpenTP1の障害時に必要となるファイルを取得します。OpenTP1の障害時に必要となるファイルについては，マニュアル「分散トランザクション処理機能 OpenTP1 運用と操作」を参照してください。

注※7

HiRDBの障害時に必要となるファイルを取得します。HiRDBの障害時に必要となるファイルについては，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

(2)　プロセス起動時に生成されるファイル

プロセス起動時に生成されるファイルを次に示します。なお，これらのファイルは，すべて（通信サーバfor Billerセットアップディレクトリ）/spool/に生成されます。

表9-2　プロセス起動時に生成されるファイル

生成されるファイル
ディレクトリ
ディレクトリ名
ファイルに出力される内容

プロセス別トレースファイル（制御電文受信CUP）
HMpnCtlRecv[n].log
/bl/cup/
制御プロセスログ用ディレクトリ
制御電文受信CUPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（業務電文受信CUP）
HMpnBusRecv[n].log
業務電文受信CUPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（制御電文受信CUP監視プロセス）
HMpnMonCtl[n].log
/bl/mon/
障害監視プロセスログ用ディレクトリ
制御電文受信CUP監視プロセスのエラーメッセージ，および警告メッセージ

プロセス別トレースファイル（業務電文受信CUP監視プロセス）
HMpnMonBus[n].log
業務電文受信CUP監視プロセスのエラーメッセージ，および警告メッセージ

プロセス別トレースファイル（SPP障害監視プロセス）
HMpnMonSpp[n].log
業務系SPP障害監視プロセスのエラーメッセージ，および警告メッセージ

プロセス別トレースファイル（OpenTP1障害監視プロセス）
HMpnMonTp1[n].log
OpenTP1障害監視プロセスのエラーメッセージ，および警告メッセージ

プロセス別トレースファイル（収納カウンタ取得SPP）
HMpnCntSpp[n].log
/bl/cnt/
収納カウンタ取得プロセスログ用ディレクトリ
収納カウンタ取得SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（収納業務受付SPP）
HMpnRdbSpp[n].log
/bl/rdb/
収納業務受付プロセスログ用ディレクトリ
収納業務受付SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（照会SPP）
HMpnRefSpp[n].log
/bl/bus/（収納機関コード）/
業務系SPPログ用ディレクトリ
照会SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（消込SPP）
HMpnPaySpp[n].log
消込SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（取消SPP）
HMpnCanSpp[n].log
取消SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（再送確認SPP）
HMpnResSpp[n].log
再送確認SPPのエラーメッセージ，警告メッセージおよび動作履歴

プロセス別トレースファイル（プロセス監視デーモン）
MonSpool_BL[n].log
/Mon/
プロセス監視デーモンログ用ディレクトリ
プロセス監視デーモンのエラーメッセージ，警告メッセージおよび動作履歴

9.1.2　環境変数の設定内容

必要に応じて，通信サーバ管理者の実行環境に設定されている環境変数の一覧をファイルに出力してください。コマンドの実行例を次に示します。

$ env > 環境変数の設定内容を出力するファイル名

9.1.3　DBのテーブルに出力される障害情報

DBのテーブルに出力される情報からも，障害情報を取得できます。

通信サーバfor Billerは，DBの電文履歴格納用テーブルに，通信サーバfor BillerとMPNセンタとの間で送受信した電文の履歴を格納しています。また，障害情報格納用テーブルに，電文履歴として取得されないで破棄される不正電文情報を格納しています。これらの情報から，障害の内容を調査できます。

また，不正電文情報を格納すると，情報メッセージを表示します。次の条件に一つでも該当する電文の情報を，不正電文情報として格納します。この表を基に，障害情報を解析してください。

表9-3　不正電文情報を取得するタイミングとその条件

不正電文情報を取得するタイミング
不正電文情報となる電文条件

MPNセンタからの依頼電文受信直後

電文長が173バイト以下，または10,160バイト以上の場合

電文種別コード，または収納機関コードが不正の場合

収納業務プログラム応答直後

制御ヘッダー部の長さが97バイト以下の場合

電文長が168バイト以下，または10,160バイト以上の場合※

電文形式が不正の場合※

電文属性が不正の場合※

ビットマップ部が不正の場合※

コード変換ができない項目があった場合※

注※

照会応答電文，または取消応答電文だけの条件です。

電文履歴格納用テーブルに格納する情報の詳細については，「表5-2　電文履歴格納用テーブルの形式」を参照してください。また，障害情報格納用テーブルに格納する情報の詳細については，「表5-9　障害情報格納用テーブルの形式」を参照してください。

9.2　通信サーバfor Billerの障害対策

通信サーバfor Billerの障害対策として，プロセス監視機能があります。ここでは，プロセス監視機能の概要，各プロセスで障害が発生した場合の対処方法，および共通ソフトウェアのチャネルの障害について説明します。

＜この節の構成＞

9.2.1　プロセス監視機能の概要

9.2.2　各プロセスの障害と対処

9.2.3　共通ソフトウェアのチャネルの障害

9.2.1　プロセス監視機能の概要

プロセス監視機能とは，通信サーバfor Billerの運用に必要なプロセスの障害監視をする機能です。プロセス監視機能では，プロセス監視デーモンまたは監視プロセスが，監視対象のプロセスがあるかどうかを監視します。

監視の結果，障害が検知された場合は，プロセスごとに決められた障害時の処理が実行されます。障害時の処理については，「9.2.2　各プロセスの障害と対処」を参照してください。

＜この項の構成＞

(1)　プロセス監視の種類

(2)　監視対象のプロセス

(3)　プロセス監視の開始と終了

(1)　プロセス監視の種類

プロセス監視の種類を次に示します。

プロセス監視デーモン

通信サーバfor Billerのオンライン機能，および共通ソフトウェアのオンライン電文処理を監視しています。

プロセス監視デーモンに障害が発生した場合は，OSがプロセス監視デーモンを再起動します。

OpenTP1監視プロセス

OpenTP1を監視しています。通信サーバシステム定義の障害監視定義で，監視する間隔，および監視する回数を指定してください。

障害監視定義については，「4.4.4(7)　障害監視定義」を参照してください。

制御電文CUP監視プロセス，業務電文受信CUP監視プロセス

制御電文受信CUP，および業務電文受信CUPを監視しています。通信サーバシステム定義の障害監視定義で，監視する間隔，監視する回数などを指定してください。

障害監視定義については，「4.4.4(7)　障害監視定義」を参照してください。

SPP障害監視プロセス

各業務系SPP，収納カウンタSPP，および収納業務受付SPPを監視しています。業務系SPPのうち，どのSPPで障害を検知しても，収納機関単位ですべての業務系SPPを停止します。そのため，監視対象から外したいSPPがある場合，通信サーバシステム定義の障害監視対象外ユーザサーバ定義で，障害監視での監視対象外とするSPPのユーザサーバ名を指定してください。

なお，OpenTP1の定義の各ユーザサービス定義で，各プロセスの異常終了回数を監視する限界経過時間，状態回復時の条件などを指定してください。

障害監視対象外ユーザサーバ定義については，「4.4.4(8)　障害監視対象外ユーザサーバ定義」を参照してください。また，OpenTP1の定義の各ユーザサービス定義については，「4.2.4　OpenTP1の定義項目」を参照してください。

(2)　監視対象のプロセス

通信サーバfor Billerのプロセスは，プロセス監視デーモン，OpenTP1監視プロセス，制御電文/業務電文受信CUP監視プロセスおよびSPP障害監視プロセスによって監視されます。これらのプロセスは，監視対象とするプロセスがそれぞれ異なります。監視対象のプロセスを次に示します。

図9-1　監視対象のプロセス

(3)　プロセス監視の開始と終了

プロセス監視デーモン，OpenTP1監視プロセス，制御電文/業務電文受信CUP監視プロセス，およびSPP障害監視プロセスは，通信サーバfor Billerが起動したときに監視を開始し，通信サーバfor Billerが停止したときに監視を終了します。その間，一定間隔でプロセスを監視します。プロセスの監視期間を次に示します。

図9-2　プロセスの監視期間

9.2.2　各プロセスの障害と対処

運用中に各プロセスで障害が発生すると，システムの回復が必要になります。ここでは，各プロセスで障害が発生した場合の通信サーバfor Billerの処理，およびシステムを回復させるための対処について説明します。

なお，構成の違いによってその方法は異なります。運用している通信サーバfor Billerの構成に合わせて処理してください。

＜この項の構成＞

(1)　HA構成の場合

(2)　クラスタ構成の場合

(1)　HA構成の場合

HA構成の場合，各プロセスでの障害が発生したときは，次のように対処してください。

注意

予備系の通信サーバfor Billerが待機状態ではない間に，現用系の通信サーバfor Billerに障害が発生した場合，系切り替えは行われません。この場合，障害が発生した要因を取り除いたあと，予備系の通信サーバfor Billerを待機状態にし，通信サーバfor Billerの起動コマンド（hmpnstart）で強制起動してください。

表9-4　各プロセスでの障害と対処（HA構成の場合）

障害が発生したプロセス
通信サーバfor Billerの処理
ユーザーの対処

共通ソフトウェア
系切り替えを行います。
障害が発生した要因を取り除いたあと，OpenTP1を待機サーバとして起動し，予備系として待機させてください。

HiRDB（通信サーバfor Billerと同一マシン上にセットアップする場合）※1
出力されるメッセージに従って障害が発生した要因を取り除いたあと，HiRDBおよびOpenTP1を待機サーバとして起動し，予備系として待機させてください。
HiRDBの障害の対処方法については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

HiRDB（通信サーバfor Billerと別のマシンにセットアップする場合）
HiRDBがダウンしたことで，正常な系切り替えが行われず，通信サーバfor Billerもダウンします。
出力されるメッセージに従って障害が発生した要因を取り除いたあと，HiRDBを再起動してください。また，OpenTP1を待機サーバとして起動し，予備系として待機させてください。
HiRDBの障害の対処方法については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

OpenTP1
系切り替えを行います。
障害が発生した要因を取り除いたあと，OpenTP1を待機サーバとして起動し，予備系として待機させてください。

プロセス監視デーモン
OSで再起動します。
－

制御電文受信CUP
業務電文受信CUP
ダウンした制御電文/業務電文受信CUPを再起動します。また，一定時間内に一定回数以上障害で停止した場合，系切り替えを行います。
障害が発生した要因を取り除いたあと，OpenTP1を待機サーバとして起動し，予備系として待機させてください。

収納カウンタ情報取得SPP※1
ダウンしたSPPを再起動します。ただし，SPPサービスが閉塞した場合，系切り替えを行います。
障害が発生した要因を取り除いたあと，OpenTP1を待機サーバとして起動し，予備系として待機させてください。

収納業務受付SPP※1

業務系SPP※1
ダウンした業務系SPPを再起動します。ただし，SPPサービスが閉塞した場合，収納機関単位で業務系SPPをすべて強制停止します。この場合，該当する収納機関サービスは停止します。この障害に該当しない収納機関サービスには影響ありません。
障害が発生した要因を取り除いたあと，状況に応じて該当する収納機関サービスを再起動してください。また，状況に応じてOpenTP1を再起動してください。

監視プロセス
系切り替えを行います。
障害が発生した要因※2を取り除いたあと，OpenTP1を再起動してください。

（凡例）

－：特になし

注※1

障害監視対象外ユーザサーバ定義に定義しているSPPはSPP障害監視プロセスが監視しないため，障害が発生しても通信サーバfor Billerは処理しません。SPP障害監視プロセスについては，「9.2.1(1)　プロセス監視の種類」を参照してください。

注※2

監視プロセス自体の障害では，メッセージが表示されます。メッセージに従って障害が発生した要因を取り除いてください。

(2)　クラスタ構成の場合

クラスタ構成の場合，各プロセスでの障害が発生したときは，次のように対処してください。

表9-5　各プロセスでの障害と対処（クラスタ構成の場合）

障害が発生したプロセス
通信サーバfor Billerの処理
ユーザーの対処

共通ソフトウェア
障害が発生した通信サーバfor Billerだけ強制停止します。
障害が発生した要因を取り除いたあと，OpenTP1および通信サーバfor Billerを再起動してください。※1
回復したあとは，クラスタ構成の通信サーバとして運用できます。

HiRDB
出力されるメッセージに従って障害が発生した要因を取り除いたあと，HiRDB，OpenTP1および通信サーバfor Billerを再起動してください。※1
回復したあとは，クラスタ構成の通信サーバとして運用できます。
HiRDBの障害の対処方法については，マニュアル「スケーラブルデータベースサーバ HiRDB システム運用ガイド」を参照してください。

OpenTP1
障害が発生した要因を取り除いたあと，OpenTP1および通信サーバfor Billerを再起動してください。※1
回復したあとは，クラスタ構成の通信サーバとして運用できます。

プロセス監視デーモン
OSで再起動します。
－

制御電文受信CUP
業務電文受信CUP
ダウンした制御電文/業務電文受信CUPを再起動します。また，一定時間内に一定回数以上障害で停止した場合，障害が発生した通信サーバfor Billerだけ強制停止します。
障害が発生した要因を取り除いたあと，OpenTP1および通信サーバfor Billerを再起動してください。

収納カウンタ情報取得SPP※2
ダウンしたSPPを再起動します。ただし，SPPサービスが閉塞した場合，障害が発生した通信サーバfor Billerだけ強制停止します。
障害が発生した要因を取り除いたあと，OpenTP1および通信サーバfor Billerを再起動してください。※1
回復したあとは，クラスタ構成の通信サーバとして運用できます。

収納業務受付SPP※2

業務系SPP※2
ダウンした通信サーバの業務系SPPを再起動します。ただし，SPPサービスが閉塞した場合，収納機関単位で業務系SPPをすべて強制停止します。この場合，ほかの通信サーバの業務系SPPが起動していれば，この障害に該当する収納機関サービスは停止しません。
障害が発生した要因を取り除いたあと，該当する収納機関サービスを再起動してください。

監視プロセス
障害が発生した通信サーバfor Billerを強制停止します。
障害が発生した要因※3を取り除いたあと，OpenTP1および通信サーバfor Billerを再起動してください。

（凡例）

－：特になし

注※1

通信サーバfor Billerの再起動には，通信サーバfor Billerの起動コマンド（hmpnstart）にオプションを指定して強制起動してください。

注※2

障害監視対象外ユーザサーバ定義に定義しているSPPはSPP障害監視プロセスが監視しないため，障害が発生しても通信サーバfor Billerは処理しません。SPP障害監視プロセスについては，「9.2.1(1)　プロセス監視の種類」を参照してください。

注※3

監視プロセス自体の障害では，メッセージが表示されます。メッセージに従って障害が発生した要因を取り除いてください。

9.2.3　共通ソフトウェアのチャネルの障害

共通ソフトウェアでは，プロセスの障害以外に，チャネルの状態不正が発生するおそれがあります。チャネルの状態が，RUNNINGまたはSTOPPED以外の場合，運用している通信サーバの構成形態に関係なく，警告メッセージまたはエラーメッセージが表示されます。メッセージが表示されたあと，チャネルの状態を調査し，障害が発生した要因を取り除いてください。回復したあと，必要に応じて開局してください。

10.　コマンドリファレンス

この章では，コマンドを実行できるユーザー，実行時の注意，使用方法，書式などについて説明します。

＜この章の構成＞

10.1　コマンドを実行する前に

10.2　コマンド一覧

10.3　コマンドの詳細

10.1　コマンドを実行する前に

ここでは，コマンドを実行できるユーザー，およびコマンド実行時の注意について説明します。

＜この節の構成＞

10.1.1　コマンドを実行できるユーザー

10.1.2　コマンド実行時の注意

10.1.1　コマンドを実行できるユーザー

コマンドの実行に必要な権限は，コマンドの種類によって異なります。

セットアップコマンド（hmpnsetup）の場合

セットアップコマンドを実行するユーザーは，スーパーユーザーである必要があります。なお，スーパーユーザーの環境には，環境変数LANG，およびTZを必ず設定してください。

上記以外のコマンドの場合

上記以外のコマンドを実行するユーザーは，通信サーバ管理者である必要があります。

10.1.2　コマンド実行時の注意

コマンド実行時は，次の点に注意してください。

環境変数について

コマンドを実行するには，通信サーバfor Billerの環境変数が設定されている必要があります。環境変数については，「3.2　通信サーバ管理者の設定」を参照してください。

オプションの指定について

コマンドのオプションの値として，ワイルドカードは使用できません。

メッセージの出力について

メッセージの可変部分を通信サーバfor Billerが特定できない場合は，メッセージの可変部分に「*」が出力されます。

10.2　コマンド一覧

通信サーバfor Billerでは，利用する収納サービスによって実行できるコマンドが異なります。通信サーバfor Billerのコマンドを次に示します。

表10-1　通信サーバfor Billerのコマンド一覧

コマンド | 機能 | 各収納サービスでの実行可否
地方税・地公体料金 | 一般料金 | 国庫金
hmpnstart | 通信サーバfor Billerの起動 | ○ | ○ | ○
hmpnstop | 通信サーバfor Billerの停止 | ○ | ○ | ○
hmpnsvopen | 収納機関サービスの起動 | ○ | ○ | ○
hmpnsvclose | 収納機関サービスの停止 | ○ | ○ | ○
hmpnopen | オンライン開始（開局） | ○ | ○ | ○
hmpnclose | オンライン終了（閉局） | ○ | ○ | ○
hmpnstat | 状態表示 | ○ | ○ | ○
hmpncntget | 収納カウンタ情報取得 | ○ | ○ | ○
hmpnbilload | 納付情報の一括登録 | ○ | ○ | ×
hmpndemload | 請求情報の一括登録 | ○ | ○ | ×
hmpnpayfile | 消込情報ファイルの変換 | ○ | ○ | ×
hmpnpayload | 一括消込 | ○ | ○ | ×
hmpnpaylist | 消込情報の出力 | ○ | ○ | ○
hmpnbnkctl | 金融機関情報の変更 | ○ | ○ | ○
hmpnrcvctl | 収納機関情報の変更 | ○ | ○ | ×
hmpnblinit | ファイル初期化 | ○ | ○ | ○
hmpnsetup | セットアップ | ○ | ○ | ○

（凡例）

○：実行できる

×：実行できない

通信サーバfor Billerで実行するコマンドは，通信サーバfor Billerの状態によって実行できるコマンドと実行できないコマンドがあります。各コマンドが実行できるタイミングを，次に示します。

表10-2　通信サーバfor Billerでコマンドを実行できるタイミング

コマンド | 通信サーバfor Billerの状態
起動中 | 停止中
開局中 | 閉局中
hmpnstart | ●※1 | ●※1 | ○
hmpnstop | ● | ●※2 | ●※1
hmpnsvopen | ○※3 | ○※3 | ×
hmpnsvclose | ○※4 | ○※4 | ×
hmpnopen | ● | ○ | ×
hmpnclose | ○ | ● | ×
hmpnstat | ○ | ○ | ○
hmpncntget | ○ | × | ×
hmpnbilload | ×※5 | ×※5 | ○
hmpndemload | ×※5 | ×※5 | ○
hmpnpayfile | ○ | ○ | ○
hmpnpayload | ×※5 | ×※5 | ○
hmpnpaylist | ○ | ○ | ○
hmpnbnkctl | × | × | ○
hmpnrcvctl | × | × | ○
hmpnblinit | × | × | ○
hmpnsetup | － | － | －

（凡例）

○：実行できる

●：強制オプション指定の場合は実行できる

×：実行できない

－：該当なし

注※1

オプションなしの場合，メッセージが出力され処理が中断されます。

注※2

収納機関サービスが停止中の場合は，強制オプション指定なしで実行できます。

注※3

収納機関サービスが起動中の場合は，実行できません。収納機関サービスが予備閉局中および停止中の場合は，実行できます。

注※4

収納機関サービスが停止中の場合は，強制オプションを指定すると，実行できます。

注※5

通信サーバfor Billerの起動中にも実行できますが，通信サーバfor Billerの停止中での実行を推奨します。なお，納付情報の一括登録コマンド（hmpnbilload），請求情報の一括登録コマンド（hmpndemload），および一括消込コマンド（hmpnpayload）を通信サーバfor Billerの起動中に実行すると，一定時間DBを占有するため，オンライン性能に影響が出ます。

また，同じ収納機関コードで，次に示す一方のコマンドを実行しているときは，もう一方のコマンドを実行できません。

・納付情報の一括登録コマンドおよび一括消込コマンド

・請求情報の一括登録コマンドおよび一括消込コマンド

10.3　コマンドの詳細

各コマンドの記述形式，機能などについて説明します。

＜この節の構成＞

hmpnstart（通信サーバfor Billerの起動）

hmpnstop（通信サーバfor Billerの停止）

hmpnsvopen（収納機関サービスの起動）

hmpnsvclose（収納機関サービスの停止）

hmpnopen（開局）

hmpnclose（閉局）

hmpnstat（状態表示）

hmpncntget（収納カウンタ情報取得）

hmpnbilload（納付情報の一括登録）

hmpndemload（請求情報の一括登録）

hmpnpayfile（消込情報ファイルの変換）

hmpnpayload（一括消込）

hmpnpaylist（消込情報の出力）

hmpnbnkctl（金融機関情報の変更）

hmpnrcvctl（収納機関情報の変更）

hmpnblinit（ファイル初期化）

hmpnsetup（セットアップ）

hmpnstart（通信サーバfor Billerの起動）

形式

hmpnstart [[-F]|[-R]]

機能

通信サーバfor Billerを起動します。共通ソフトウェアも，通信サーバfor Billerの起動処理中に起動されます。

次のような場合は，必ず強制起動してください。

前回停止時に，強制停止した

前回異常終了した

強制起動のオプションは，停止時の開閉局状態を引き継いで起動する場合と，開閉局状態を引き継がない場合で異なります。

オプション

-F

障害停止時の収納機関サービスの状態および開閉局状態を引き継がずに，通信サーバfor Billerを強制起動する場合に指定します。

クラスタ構成で，自動開局定義に「AUTO」を指定している場合は，ほかの通信サーバがすべて停止している，または開局できる状態のときだけ開局処理を実行します。

-R

障害停止時の収納機関サービスの状態および開閉局状態を引き継いで強制起動する場合に指定します。

クラスタ構成で，ほかの通信サーバがすべて停止している場合は，開閉局状態が開局中または開局処理中の場合は開局処理を，閉局処理中の場合は閉局処理を実行します。ほかの通信サーバが起動中で，ほかの通信サーバで開閉局処理が実行されていない場合，開閉局状態が開局処理中の場合は開局処理を，閉局処理中の場合は閉局処理を実行します。

戻り値

0：正常終了

0以外：エラーリターン※

注※

通信サーバfor Billerの起動コマンドでエラーリターンとなる条件を次に示します。

通信サーバfor Billerの起動に失敗した場合

通信サーバfor Billerの起動は成功したが，収納機関サービスの自動起動に失敗した場合

通信サーバfor Billerの起動は成功したが，自動開局でMPNセンタとの開局に失敗した場合

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。

hmpnstart

hmpnstop

hmpnopen

hmpnclose

hmpnsvopen

hmpnsvclose

hmpncntget

障害停止した場合，通信サーバfor Billerの起動コマンドは，次の共通ソフトウェアのプロセスが停止している状態を確認し，実行してください。これらのプロセスが一つでも起動している状態で実行すると，通信サーバfor Billerのプロセスを正常に起動できません。
オンライン電文用キューマネージャー配下のプロセス

amqhasmx

amqrrmfa

amqzlaa0

amqzllp0

amqzxma0

runmqchi

開局中または収納機関サービスの起動中に，オプションを指定しないで通信サーバfor Billerの起動コマンドを実行した場合，メッセージが出力され，処理が中断されます。

hmpnstop（通信サーバfor Billerの停止）

形式

hmpnstop [[-F]|[-C]]

機能

通信サーバfor Billerを停止します。

次の場合に停止するときは，強制停止を指定してください。

開閉局状態が「開局中」

収納機関サービスが「起動中」または「予備閉局中」

オプション

-F

通信サーバfor Billerを強制停止する場合に指定します。強制停止を指定した場合は，仕掛中のプロセスも強制的に停止します。

-C

クラスタ構成での運用中に，一部の通信サーバを停止しクラスタ構成から切り離す場合に指定します。

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。

hmpnstart

hmpnstop

hmpnopen

hmpnclose

hmpnsvopen

hmpnsvclose

hmpncntget

「-F」オプションを指定して強制停止した場合は，次回起動時に必ず強制起動を指定してください。

クラスタ構成での運用中に，最後に停止させる通信サーバに対して「-C」オプションを指定し，実行しないでください。正常に電文を処理できないおそれがあります。

hmpnsvopen（収納機関サービスの起動）

形式

hmpnsvopen {-a|-s 収納機関コード}

機能

収納機関サービスを起動，または予備閉局を解除します。

オプション

-a

このオプションを指定すると，通信サーバシステム定義に定義したすべての収納機関に対して，処理を実行します。

-s 収納機関コード～<符号なし整数>((00000000～99999999))

通信サーバシステム定義に定義した収納機関コードを指定します。このオプションを指定すると，特定の収納機関に対して，処理を実行します。

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。ただし，hmpnsvopenおよびhmpnsvcloseについては，収納機関コードが異なれば実行できます。

hmpnstart

hmpnstop

hmpnsvopen

hmpnsvclose

hmpnsvclose（収納機関サービスの停止）

形式

hmpnsvclose {-a|-a -p|-s 収納機関コード -c|-s 収納機関コード -p|-s 収納機関コード -F}

機能

収納機関サービスを停止，または予備閉局します。

オプション

-a

このオプションを指定すると，通信サーバシステム定義に定義したすべての収納機関に対して，処理を実行します。

-p

収納機関サービスを予備閉局する場合に指定します。

-s 収納機関コード～<符号なし整数>((00000000～99999999))

通信サーバシステム定義に定義した収納機関コードを指定します。このオプションを指定すると，特定の収納機関に対して，処理を実行します。

-c

収納機関サービスを停止する場合に指定します。

-F

収納機関サービスを強制停止する場合に指定します。

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。ただし，hmpnsvopenおよびhmpnsvcloseについては，収納機関コードが異なれば実行できます。

hmpnstart

hmpnstop

hmpnsvopen

hmpnsvclose

クラスタ構成の場合，複数の通信サーバが起動しているため，「-p」オプションを指定して予備閉局するときは，起動しているすべての通信サーバでコマンドを実行してください。

hmpnopen（開局）

形式

hmpnopen [-F]

機能

MPNセンタに開始要求を通知し，通信サーバfor Billerの開閉局状態を「開局中」にします。

MPNセンタと通信サーバfor Billerの開閉局状態が一致しない場合は，強制開局してください。

このコマンドは，共通ソフトウェアの送受信チャネルの接続状態がすべてRUNNINGのときだけ，開始要求を通知します。

オプション

-F

強制開局する場合に指定します。強制開局を指定した場合は，開閉局状態が「開局中」の場合でも，MPNセンタに開始要求を通知します。

強制開局オプションを指定した場合は，共通ソフトウェアの送受信チャネルの接続状態に関係なく，強制開局できます。

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。

hmpnstart

hmpnstop

hmpnopen

hmpnclose

hmpncntget

hmpnclose（閉局）

形式

hmpnclose {-c|-t [閉局待ち時間]|-F}

機能

MPNセンタに終了要求を通知し，通信サーバfor Billerの開閉局状態を「閉局中」にします。

MPNセンタと通信サーバfor Billerの開閉局状態が一致しない場合は，強制閉局してください。

オプション

-c

閉局する場合に指定します。

-t 閉局待ち時間～<符号なし整数>((0～600))（単位：秒）

すべての収納機関サービスの状態を「予備閉局中」にしてから，閉局処理待ち時間が経過したあと，通信サーバfor Billerの開閉局状態を「閉局中」にする場合に指定します。閉局処理待ち時間は，次の計算式によって算出されます。なお，閉局待ち時間を省略した場合は，0秒が仮定されます。

閉局処理待ち時間＝仕掛中の電文の処理を終了するまでの待ち時間（900秒）+閉局待ち時間（このオプションで指定する値）

-F

強制閉局する場合に指定します。強制閉局を指定した場合は，開閉局状態が「閉局中」の場合でも，MPNセンタに終了要求を通知します。

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。

hmpnstart

hmpnstop

hmpnopen

hmpnclose

hmpncntget

コマンドが終了応答待ちでタイムアウトした場合でも，開閉局状態は「閉局中」になります。

hmpnstat（状態表示）

形式

hmpnstat [-s 収納機関コード]

機能

通信サーバfor Billerの構成の種類，起動状態，開閉局状態および収納機関ごとの収納機関サービスの状態を表示します。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

収納機関ごとの収納機関サービスの状態を表示する場合に指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

表示形式

コマンドを実行すると，通信サーバfor Billerの構成の種類，起動状態，開閉局状態および収納機関ごとの収納機関サービスの状態が次の形式で表示されます。

日本語・「-s」オプションなしの場合

KDMQCD300-I　構成種別：通信サーバfor Billerの構成の種類
KDMQCD301-I　起動／停止状態：通信サーバfor Billerの起動状態
KDMQCD302-I　開局／閉局状態：通信サーバfor Billerの開閉局状態
KDMQCD303-I　収納機関の状態表示を開始します。
KDMQCD304-I　収納機関コード　収納機関サービスの状態
KDMQCD304-I　収納機関コード　収納機関サービスの状態
KDMQCD304-I　収納機関コード　収納機関サービスの状態
KDMQCD305-I　収納機関の状態表示を終了します。

日本語・「-s」オプションありの場合

KDMQCD303-I　収納機関の状態表示を開始します。
KDMQCD304-I　収納機関コード　収納機関サービスの状態
KDMQCD305-I　収納機関の状態表示を終了します。

表示形式の太字および下線で示した個所は，次のコードが表示されます。

通信サーバfor Billerの構成の種類

・SINGLE：単一構成

・HA：HA構成

・CLUSTER：クラスタ構成

・*：クラスタ構成とHA構成が混在（定義チェック未実施）

通信サーバfor Billerの起動状態

・RUN：起動中

・STOP：停止中

通信サーバfor Billerの開閉局状態

・OPEN：開局中

・CLOSE：閉局中

・OPENING：開局処理中

・CLOSING：閉局処理中

収納機関コード

状態を表示する収納機関の収納機関コード

収納機関サービスの状態

・RUN：起動中

・STOP：停止中

・PRE-CLOSE：予備閉局中

戻り値

オプションなしの場合

0：閉局中

1：開局中

3：開局処理中

4：閉局処理中

上記以外：エラーリターン

「-s」オプションありの場合

0：停止中

1：起動中

2：予備閉局中

上記以外：エラーリターン

注意

クラスタ構成で，DBが起動していないときにコマンドを実行すると，エラーとなります。

強制停止オプションを指定して通信サーバを停止した場合，通信サーバfor Billerの開閉局状態，収納機関サービスの状態を更新しないで停止します。そのため，通信サーバ強制停止後に状態表示コマンドを実行すると，通信サーバfor Billerの開閉局状態，収納機関サービスの状態は，強制停止を実行した時点の状態が表示されます。

hmpncntget（収納カウンタ情報取得）

形式

hmpncntget -c カウンタ日付 [-p]

機能

MPNセンタが管理する収納カウンタ情報を取得します。収納カウンタ情報は，DBに保存されます。

オプション

-c カウンタ日付～<符号なし整数>

取得する収納カウンタ情報の日付を指定します。日付の形式は，yyyymmdd（yyyy：年，mm：月，dd：日）です。取得できる収納カウンタ情報は，コマンド実行日の当日，前日および前々日だけです。

-p

収納カウンタ情報を標準出力に表示する場合に指定します。このオプションを指定しない場合は，標準出力に表示されません。

表示形式

収納カウンタ情報の表示例を次に示します。

英語の表示例

日本語の表示例

戻り値

0：正常終了

0以外：エラーリターン

注意

このコマンドは，通信サーバfor Billerの開閉局状態が開局中のときだけ実行できます。

このコマンドの実行中は，次のコマンドを実行できません。コマンドが終了したあとに実行してください。

hmpnstart

hmpnstop

hmpnopen

hmpnclose

hmpncntget

クラスタ構成の場合，収納カウンタ情報取得コマンドは，一つの通信サーバで実行してください。

hmpnbilload（納付情報の一括登録）

形式

HiRDB/Single Serverの場合
hmpnbilload -s 収納機関コード -f 入力情報ファイル名 [-c [エラー件数]|[[-o [-rd RDエリア名]] [-nc]]] [-r 結果報告ファイル名]

HiRDB/Parallel Serverの場合
hmpnbilload -s 収納機関コード -f 入力情報ファイル名 {-c [エラー件数]|-sv サーバ名 [-o [-rd RDエリア名]] [-nc [-st セットアップディレクトリ]]} [-r 結果報告ファイル名]

機能

複数の納付情報をDBへ一括登録します。

「-c」オプション，および「-nc」オプションを指定しない場合，入力情報ファイルをチェックし，DBへ一括登録します。また，この場合，出力されるエラーメッセージは1件までとなります。なお，「-c」オプションを指定する場合，エラーメッセージは指定した件数だけ表示されます。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

納付情報を一括登録する収納機関の，収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-f 入力情報ファイル名～<パス名>(1～PATH_MAX文字)

入力情報ファイル名を絶対パス，または相対パスで指定します。「,」を含むディレクトリ，またはファイル名を指定できません。

入力情報ファイルは，納付情報を入力したDAT形式のファイルです。DBの納付情報格納用テーブルと同じ書式をテキストファイルで，前もって作成しておきます。入力情報ファイルの形式を次に示します。表にある桁数の範囲，および属性で，MPNの仕様に基づいて作成してください。

表10-3　入力情報ファイルの形式（納付情報）

項目名 | 内容 | 桁数 | 属性
RECV_CODE | 収納機関コード | 8 | n
CUST_NO※1 | 納付番号 | 1～20 | an
CONF_NO※1 | 確認番号 | 1～6 | an
PAY_CLS※1 | 納付区分 | 3～16 | n
OCR_INFO | OCR情報 | 0，83 | －
BARCODE_INFO | バーコード情報 | 0～50 | n
PAY_FORM | 支払形態 | 1 | n
USER_NAME_KANA | 利用者名（カナ） | 0～24 | ank
USER_NAME_KANJI | 利用者名（漢字） | 0～12 | K
PASSWD | パスワード | 0～20 | an
RECV_NAME_KANA | 収納機関名（カナ） | 1～24 | ank
RECV_NAME_KANJI | 収納機関名（漢字） | 1～12 | K
ID_NO | 識別番号 | 20 | an
PAY_DOC_TYPE | 払込書区分 | 1 | n
PAY_TOTAL | 納付合計額 | 11 | n
PAY_AMT | 納付額 | 11 | n
ARRE_SHOW_TYPE | 延滞金表示区分 | 1 | n
OVERDUE | 延滞金 | 8 | n
COMM_BRDN_TYPE | 手数料負担区分 | 1 | n
PAY_CONT_KANA | 納付内容（カナ） | 24 | ank
PAY_CONT_KANJI | 納付内容（漢字） | 12 | K
DEMAND | 督促手数料 | 0～11 | －
PREPAID | 前納報奨金 | 0～11 | －
PUBLIC_OPTION | 地公体任意情報 | 0～20 | ank
CHARGE_TYPE | 手数料負担区分 | 0，1 | n
PAY_LIMIT_DATE | 消込期限年月日 | 0，8 | date
PAY_MTHD | 納付方式 | 0，1 | n
DETAIL_PRNT_KANA | 詳細印字（カナ） | 0，24 | ank
DETAIL_PRNT_KANJI | 詳細印字（漢字） | 0，12 | K
DETAIL_SHOW1_KANA | 詳細表示1（カナ） | 0～150 | ank
DETAIL_SHOW1_KANJI | 詳細表示1（漢字） | 0～75 | K
DETAIL_SHOW2_KANA | 詳細表示2（カナ） | 0～150 | ank
DETAIL_SHOW2_KANJI | 詳細表示2（漢字） | 0～75 | K
PAY_YEAR | 納付年度 | 0～4 | －
PAY_STP_INFO | 支払停止情報 | 0～1 | －
PAY_STP_CHANNEL | 支払停止チャネル | 0～1 | －
NONPYA_SHOW_INFO | 未納表示情報 | 0～1 | －
EXTRA_INFO | 期割情報 | 0～2 | －
REPLACE_INFO | 差替情報 | 0～1 | －
PAID_FLAG | 支払済フラグ | 0～1 | －
CAN_FLAG | 取消停止フラグ | 0～1 | －
YOBI※2 | 予備 | 0～360 | －

（凡例）

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

ank：《英字》，《数字》，《カナ》，《記号》，《カナ記号》，およびSPACE

K：《全角文字》

date：年月日を表す《数字》

－：属性チェックなし

注※1

これらの項目に指定したデータの組み合わせは，ほかのデータと重複しないように指定してください。

注※2

任意で使用できる領域です。

また，これらのファイルはDAT形式のため，作成する場合は次の点に注意してください。

各項目のデータは，SJISコードで指定してください。

各項目のデータを必ず「""」で囲んでください。

「""」で囲む中にデータを指定していないと，NULLと同じように処理されます。この項目の属性がVARCHAR，またはNVARCHARのとき，長さは0になります。

各項目は，「,」で区切ってください。データの中の「,」は，データとして処理されます。

入力情報ファイルの形式例を次に示します。入力情報ファイルは，収納機関ごとに作成してください。また，消込カウンタ，取消カウンタ，作成日，および作成時刻は，通信サーバfor Billerがデータを作成および編集します。

"収納機関コード","納付番号","確認番号","納付区分"," OCR情報","バーコード情報","支払形態","利用者名（カナ）","利用者名（漢字）","パスワード","収納機関名（カナ）","収納機関名（漢字）","識別番号","払込書区分","納付合計額","納付額","延滞金表示区分","延滞金","手数料負担区分","納付内容（カナ）","納付内容（漢字）","督促手数料","前納報奨金","地公体任意情報","手数料負担区分","消込期限年月日","納付方式","詳細印字（カナ）","詳細印字（漢字）","詳細表示１（カナ）","詳細表示１（漢字）","詳細表示２（カナ）","詳細表示２（漢字）","納付年度","支払停止情報","支払停止チャネル","未納表示情報","期割情報","差替情報","支払済フラグ","取消停止フラグ","予備"

なお，DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-c [エラー件数]～<符号なし整数>((1～10000))（単位：件）

入力情報ファイルのチェックだけを実行する場合に指定します。

このオプションでエラー件数を指定した場合，エラーがなくなるまで，または指定した件数までエラーメッセージが出力されます。また，エラー件数を指定しない場合，1,000件までエラーメッセージが出力されます。

なお，エラー件数は1レコード当たり1件とします。そのため，1レコードに複数のエラーがあるときのエラー件数は1件となります。

-sv サーバ名～<識別子>(1～8文字)

実行サーバ名（フロントエンドサーバ名またはバックエンドサーバ名）を指定します。このオプションは，HiRDB/Parallel Serverを使用している場合に指定してください。

-o [-rd RDエリア名]～<識別子>，およびSPACE(1～30文字)

オンラインで納付情報の一括登録を実行する場合に指定します。RDエリア名を指定した場合，RDエリアを閉塞します。そのため，場合によってはオンラインの業務処理がエラーになります。RDエリア名には，通信サーバfor Billerを利用するに当たって作成した納付情報を格納するためのユーザー用RDエリア名を指定します。指定するRDエリア名が空白を含む場合，「""」で囲んでください。RDエリア名に"ALL"は指定できません。

RDエリア名を指定しない場合，RDエリアを閉塞しません。そのため，納付情報の一括登録処理とオンライン処理のどちらかが，排他待ち状態になります。RDエリアについては，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

-nc [-st セットアップディレクトリ]～<パス名>(1～PATH_MAX文字)

入力情報ファイルをチェックしないで，一括登録する場合に指定します。このオプションは，「-c」オプションで入力情報ファイルをチェックしたあと，エラーがなかった場合だけ指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，セットアップディレクトリを絶対パスで指定してください。なお，セットアップディレクトリには，実行サーバにセットアップ済みの通信サーバfor Biller，またはDB Utility for Billerのセットアップディレクトリを指定してください。

-r 結果報告ファイル名～<英数字>(1～50文字)

結果報告ファイルを出力する場合に指定します。このオプションを指定しない場合，入力情報ファイルをチェックしても，結果報告ファイルは出力されません。

結果報告ファイルは，（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/batディレクトリに格納され，テキストファイルとして出力されます。出力されるファイルの種類を次に示します。

表10-4　結果報告ファイルの種類（納付情報の一括登録）

指定したオプション | 出力されるファイルの種類
-r | -c | データチェックファイル（結果報告ファイル名.chk）
-nc | データ登録ファイル（結果報告ファイル名.rlt）
－

（凡例）

－：「-r」オプションの指定だけの場合

データチェックファイル，およびデータ登録ファイルの出力内容については，「8.4.2　納付情報の一括登録」を参照してください。

次に，データチェックファイルの出力形式を示します。

【英語：LANG=C】

KDMQCD614-E Specified input-file has error. factor=要因, line=行番号, column=列ID, detail=詳細

【日本語：LANG=Ja_JP（AIX 5Lの場合），LANG=ja_JP.SJIS（HP-UXの場合）】

KDMQCD614-E 指定された入力情報ファイルの内容に誤りがあります。要因＝要因，行番号＝行番号，列ID＝列ID，詳細＝詳細

また，データ登録ファイルはDAT形式で表示されます。納付情報を編集し，DBへの登録が失敗した場合，データ登録ファイルの最終行に失敗した登録データが出力されます。データ登録ファイルの出力形式を次に示します。

"収納機関コード","納付番号","確認番号","納付区分"," OCR情報","バーコード情報","支払形態","利用者名（カナ）","利用者名（漢字）","パスワード","収納機関名（カナ）","収納機関名（漢字）","識別番号","払込書区分","納付合計額","納付額","延滞金表示区分","延滞金","手数料負担区分","納付内容（カナ）","納付内容（漢字）","督促手数料","前納報奨金","地公体任意情報","手数料負担区分","消込期限年月日","納付方式","詳細印字（カナ）","詳細印字（漢字）","詳細表示１（カナ）","詳細表示１（漢字）","詳細表示２（カナ）","詳細表示２（漢字）","納付年度","支払停止情報","支払停止チャネル","未納表示情報","期割情報","差替情報","支払済フラグ","取消停止フラグ","予備",0,0,"作成日","作成時刻"

なお，結果報告ファイルがすでに出力されている場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，結果報告ファイルを削除し，処理は続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

戻り値

0：正常終了

1：納付情報の一括登録の中断（結果報告ファイルがすでにあり，処理の続行を指定しない場合）

2：納付情報の一括登録の中断（オンラインでコマンドを実行した場合）

上記以外：エラーリターン

注意

納付情報の一括登録コマンドの実行中に，同じ収納機関コードで納付情報の一括登録コマンド，および一括消込コマンド（hmpnpayload）を実行できません。

「-r」オプションを指定して納付情報の一括登録コマンドを実行中にエラーが発生した場合，未完成な結果報告ファイルが出力されることがあります。

納付情報の一括登録コマンド以外で，結果報告ファイルを使用している場合，「-r」オプションを指定して納付情報の一括登録コマンドを実行すると，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した結果報告ファイル名を変更して再度実行してください。

「-f」オプションで指定する入力情報ファイルには，「,」を含むディレクトリ，またはファイル名を指定できません。

通信サーバシステム定義で，納付金区分に地方税・地公体料金を指定した場合，このコマンドを実行してください。

「-o」オプションを指定する場合，通信サーバ管理者とHiRDB管理者が異なるときは，RDエリアを閉塞して一括登録処理を行う機能（「-rd」オプション）は使用できません。

通信サーバ稼働中にこのコマンドは実行できません。ただし，「-o」オプションを指定した場合は，通信サーバ稼働中でもこのコマンドを実行できます。

HiRDB/Parallel Serverを使用している場合に，このコマンドを実行するときは，システムマネジャのあるサーバでコマンドを実行してください。

HiRDB/Parallel Serverを使用している場合に，「-st」オプションを指定してこのコマンドを実行するときは，入力情報ファイルは絶対パスで指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，実行サーバ上のセットアップディレクトリ配下にエラー情報ファイルおよびデータ登録ファイルが出力されます。なお，データ登録ファイルがすでにある場合，コマンドがエラーになります。

hmpndemload（請求情報の一括登録）

形式

HiRDB/Single Serverの場合
hmpndemload -s 収納機関コード -f 入力情報ファイル名 [-c [エラー件数]|[[-o [-rd RDエリア名]] [-nc]]] [-r 結果報告ファイル名]

HiRDB/Parallel Serverの場合
hmpndemload -s 収納機関コード -f 入力情報ファイル名 {-c [エラー件数]|-sv サーバ名 [-o [-rd RDエリア名]] [-nc [-st セットアップディレクトリ]]} [-r 結果報告ファイル名]

機能

複数の請求情報をDBへ一括登録します。

「-c」オプション，および「-nc」オプションを指定しない場合，入力情報ファイルをチェックし，DBへ一括登録します。また，この場合，出力されるエラーメッセージは1件までとなります。なお，「-c」オプションを指定する場合，エラーメッセージは指定した件数だけ表示されます。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

請求情報を一括登録する収納機関の，収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-f 入力情報ファイル名～<パス名>(1～PATH_MAX文字)

入力情報ファイル名を絶対パス，または相対パスで指定します。

入力情報ファイルは，請求情報を入力したDAT形式のファイルです。DBの請求情報格納用テーブルと同じ書式をテキストファイルで，前もって作成しておきます。入力情報ファイルの形式を次に示します。表にある桁数，および属性の範囲でMPNの仕様に基づいて作成してください。

表10-5　入力情報ファイルの形式（請求情報）

項目名 | 内容 | 桁数 | 属性
RECV_CODE | 収納機関コード | 8 | n
CUST_NO※1 | お客様番号 | 1～20 | an
CONF_NO※1 | 確認番号 | 1～6 | an
OCR_INFO | OCR情報 | 0，83 | －
BARCODE_INFO | バーコード情報 | 0～50 | n
PAY_FORM | 支払形態 | 1 | n
USER_NAME_KANA | 利用者名（カナ） | 0～24 | ank
USER_NAME_KANJI | 利用者名（漢字） | 0～12 | K
PASSWD | パスワード | 0～20 | an
RECV_NAME_KANA | 収納機関名（カナ） | 1～24 | ank
RECV_NAME_KANJI | 収納機関名（漢字） | 1～12 | K
BILL_NO | 請求番号 | 20 | an
PAY_DOC_TYPE | 払込書区分 | 1 | n
BILL_TOTAL | 請求金額 | 11 | n
BILL_PRINCIPAL | 請求金額元金 | 11 | n
OVERDUE_DISP | 延滞金表示区分 | 1 | n
OVERDUE | 延滞金 | 8 | n
TAX_DISP | 消費税額表示区分 | 1 | n
TAX | 消費税額 | 10 | n
COMM_BRDN_TYPE | 手数料負担区分 | 1 | n
BILL_CONT_KANA | 請求内容（カナ） | 24 | ank
BILL_CONT_KANJI | 請求内容（漢字） | 12 | K
CHARGE_TYPE | 手数料負担区分 | 0，1 | n
PAY_LIMIT_DATE | 消込期限年月日 | 0，8 | date
DETAIL_PRNT_KANA | 詳細印字（カナ） | 0，24 | ank
DETAIL_PRNT_KANJI | 詳細印字（漢字） | 0，12 | K
DETAIL_SHOW1_KANA | 詳細表示１（カナ） | 0～150 | ank
DETAIL_SHOW1_KANJI | 詳細表示１（漢字） | 0～75 | K
DETAIL_SHOW2_KANA | 詳細表示２（カナ） | 0～150 | ank
DETAIL_SHOW2_KANJI | 詳細表示２（漢字） | 0～75 | K
PAY_YEAR | 請求年度 | 0～4 | －
PAY_STP_INFO | 支払停止情報 | 0～1 | －
PAY_STP_CHANNEL | 支払停止チャネル | 0～1 | －
NONPYA_SHOW_INFO | 未納表示情報 | 0～1 | －
EXTRA_INFO | ソート情報 | 0～2 | －
REPLACE_INFO | 差替情報 | 0～1 | －
PAID_FLAG | 支払済フラグ | 0～1 | －
CAN_FLAG | 取消停止フラグ | 0～1 | －
YOBI※2 | 予備 | 0～360 | －

（凡例）

n：《数字》

an：《英字》，《数字》，《記号》，およびSPACE

ank：《英字》，《数字》，《カナ》，《記号》，《カナ記号》，およびSPACE

K：《全角文字》

date：年月日を表す《数字》

－：属性チェックなし

注※1

これらの項目に指定したデータの組み合わせは，ほかのデータと重複しないように指定してください。

注※2

任意で使用できる領域です。

また，これらのファイルはDAT形式のため，作成する場合は次の点に注意してください。

各項目のデータは，SJISコードで指定してください。

各項目のデータを必ず「""」で囲んでください。

「""」で囲む中にデータを指定していないと，NULLと同じように処理されます。この項目の属性がVARCHAR，またはNVARCHARのとき，長さは0になります。

各項目は，「,」で区切ってください。データの中の「,」は，データとして処理されます。

入力情報ファイルの形式例を次に示します。入力情報ファイルは，収納機関ごとに作成してください。また，消込カウンタ，取消カウンタ，作成日，および作成時刻は，通信サーバfor Billerがデータを作成および編集します。

"収納機関コード","お客様番号","確認番号"," OCR情報","バーコード情報","支払形態","利用者名（カナ）","利用者名（漢字）","パスワード","収納機関名（カナ）","収納機関名（漢字）","請求番号","払込書区分","請求金額","請求金額元金","延滞金表示区分","延滞金","消費税額表示区分","消費税額","手数料負担区分","請求内容（カナ）","請求内容（漢字）","手数料負担区分","消込期限年月日","詳細印字（カナ）","詳細印字（漢字）","詳細表示１（カナ）","詳細表示１（漢字）","詳細表示２（カナ）","詳細表示２（漢字）","請求年度","支払停止情報","支払停止チャネル","未納表示情報","ソート情報","差替情報","支払済フラグ","取消停止フラグ","予備"

なお，DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-c [エラー件数]～<符号なし整数>((1～10000))（単位：件）

入力情報ファイルのチェックだけを実行する場合に指定します。

このオプションでエラー件数を指定した場合，エラーがなくなるまで，または指定した件数までエラーメッセージが出力されます。また，エラー件数を指定しない場合，1,000件までエラーメッセージが出力されます。

なお，エラー件数は1レコード当たり1件とします。そのため，1レコードに複数のエラーがあるときのエラー件数は1件となります。

-sv サーバ名～<識別子>(1～8文字)

実行サーバ名（フロントエンドサーバ名またはバックエンドサーバ名）を指定します。このオプションは，HiRDB/Parallel Serverを使用している場合に指定してください。

-o [-rd RDエリア名]～<識別子>，およびSPACE(1～30文字)

オンラインで請求情報の一括登録を実行する場合に指定します。RDエリア名を指定した場合，RDエリアを閉塞します。そのため，場合によってはオンラインの業務処理がエラーになります。RDエリア名には，通信サーバfor Billerを利用するに当たって作成した請求情報を格納するためのユーザー用RDエリア名を指定します。指定するRDエリア名が空白を含む場合，「""」で囲んでください。RDエリア名に"ALL"は指定できません。

RDエリア名を指定しない場合，RDエリアを閉塞しません。そのため，請求情報の一括登録処理とオンライン処理のどちらかが，排他待ち状態になります。RDエリアについては，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

-nc [-st セットアップディレクトリ]～<パス名>(1～PATH_MAX文字)

入力情報ファイルをチェックしないで，一括登録する場合に指定します。このオプションは，「-c」オプションで入力情報ファイルをチェックしたあと，エラーがなかった場合だけ指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，セットアップディレクトリを絶対パスで指定してください。なお，セットアップディレクトリには，実行サーバにセットアップ済みの通信サーバfor Biller，またはDB Utility for Billerのセットアップディレクトリを指定してください。

-r 結果報告ファイル名～<英数字>(1～50文字)

結果報告ファイルを出力する場合に指定します。このオプションを指定しない場合，入力情報ファイルをチェックしても，結果報告ファイルは出力されません。

結果報告ファイルは，（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/batディレクトリに格納され，テキストファイルとして出力されます。出力されるファイルの種類，および結果報告ファイルのうち，データチェックファイルの出力形式については，「hmpnbilload（納付情報の一括登録）」を参照してください。

また，データチェックファイル，およびデータ登録ファイルの出力内容については「8.4.3　請求情報の一括登録」を参照してください。

請求情報の一括登録コマンドを実行した場合の結果報告ファイルのうち，データ登録ファイルの出力形式は納付情報の一括登録の場合と異なります。次に，データ登録ファイルの出力形式を示します。

データ登録ファイルはDAT形式で表示されます。請求情報を編集し，DBへの登録が失敗した場合，データ登録ファイルの最終行に失敗した登録データが出力されます。データ登録ファイルの出力形式を次に示します。

"収納機関コード","お客様番号","確認番号","OCR情報","バーコード情報","支払形態","利用者名（カナ）","利用者名（漢字）","パスワード","収納機関名（カナ）","収納機関名（漢字）","請求番号","払込書区分","請求金額","請求金額元金","延滞金表示区分","延滞金","消費税額表示区分","消費税額","手数料負担区分","請求内容（カナ）","請求内容（漢字）","手数料負担区分","消込期限年月日","詳細印字（カナ）","詳細印字（漢字）","詳細表示１（カナ）","詳細表示１（漢字）","詳細表示２（カナ）","詳細表示２（漢字）","請求年度","支払停止情報","支払停止チャネル","未納表示情報","ソート情報","差替情報","支払済フラグ","取消停止フラグ","予備",0,0,"作成日","作成時刻"

なお，結果報告ファイルがすでに出力されている場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，結果報告ファイルを削除し，処理は続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

戻り値

0：正常終了

1：請求情報の一括登録の中断（結果報告ファイルがすでにあり，処理の続行を指定しない場合）

2：請求情報の一括登録の中断（オンラインでコマンドを実行した場合）

上記以外：エラーリターン

注意

請求情報の一括登録コマンドの実行中に，同じ収納機関コードで請求情報の一括登録コマンド，および一括消込コマンド（hmpnpayload）を実行できません。

通信サーバ稼働中に，このコマンドは実行できません。ただし，「-o」オプションを指定した場合は，通信サーバ稼働中でもこのコマンドを実行できます。

「-r」オプションを指定して請求情報の一括登録コマンドを実行中にエラーが発生した場合，未完成な結果報告ファイルが出力されることがあります。

請求情報の一括登録コマンド以外で結果報告ファイルを使用している場合，「-r」オプションを指定して納付情報の一括登録コマンドを実行すると，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した結果報告ファイル名を変更して再度実行してください。

「-f」オプションで指定する入力情報ファイルには，「,」を含むディレクトリ，またはファイル名を指定できません。

通信サーバシステム定義で，納付金区分に一般料金を指定した場合，このコマンドを実行してください。

「-o」オプションを指定する場合，通信サーバ管理者とHiRDB管理者が異なるときは，RDエリアを閉塞して一括登録処理を行う機能（「-rd」オプション）は使用できません。

HiRDB/Parallel Serverを使用している場合に，このコマンドを実行するときは，システムマネジャのあるサーバでコマンドを実行してください。

HiRDB/Parallel Serverを使用している場合に，「-st」オプションを指定してこのコマンドを実行するときは，入力情報ファイルは絶対パスで指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，実行サーバ上のセットアップディレクトリ配下にエラー情報ファイルおよびデータ登録ファイルが出力されます。なお，データ登録ファイルがすでにある場合，コマンドがエラーになります。

hmpnpayfile（消込情報ファイルの変換）

形式

hmpnpayfile -s 収納機関コード -f 伝送ファイル名 -o 消込情報ファイル名 [-c エラー件数] [-dat]

機能

伝送ファイルを消込情報ファイルに変換します。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-f 伝送ファイル名～<パス名>(1～PATH_MAX文字)

変換する伝送ファイル名を絶対パスまたは相対パスで指定します。また，伝送ファイル名の形式はMPNの仕様に従っています。伝送ファイル名の形式を次に示します。

01_aaaaa_bbbbb_mmdd_nnn

（凡例）

01：一括消込データ

aaaaa：送信元（金融機関コード）

bbbbb：送信先（収納機関コード）

mmdd：月日

nnn：任意通番

次に，伝送ファイルを消込情報ファイルに変換する設定項目の内容を示します。

表10-6　消込情報ファイルの設定項目内容

項目名
内容
項目属性
サイズ
（単位：バイト）
設定項目内容

地方税・地公体料金
一般料金

RECV_CODE
収納機関コード
CHAR
8
伝送ファイルの収納機関コード
伝送ファイルの収納機関コード

CUST_NO
お客様番号（納付番号）
VARCHAR
20
ユーザーコールバックで取得した値
（納付番号）
ユーザーコールバックで取得した値
（お客様番号）

CONF_NO
確認番号
VARCHAR
6
ユーザーコールバックで取得した値
（確認番号）
ユーザーコールバックで取得した値
（確認番号）

PAY_CLS
納付区分
VARCHAR
16
ユーザーコールバックで取得した値
（納付区分）
NULL

SRC_TRX
仕向トランザクション番号
CHAR
5
ALL0
ALL0

DST_TRX
被仕向トランザクション番号
CHAR
5
ALL0
ALL0

SRC_CODE
仕向センタコード
CHAR
10
伝送ファイルの仕向センタコード
伝送ファイルの仕向センタコード

DST_CODE
被仕向センタコード
CHAR
10
伝送ファイルの被仕向センタコード
伝送ファイルの被仕向センタコード

BANK_CODE
金融機関コード
CHAR
8
伝送ファイルの金融機関コード
伝送ファイルの金融機関コード

BRANCH_CODE
店舗コード
CHAR
6
伝送ファイルの金融機関店舗コード
伝送ファイルの金融機関店舗コード

SRC_PROCDATE
仕向処理年月日
CHAR
8
伝送ファイルの金融機関処理日
伝送ファイルの金融機関処理日

SRC_PROCTIME
仕向処理時刻
CHAR
6
ALL0
ALL0

SRC_PROCNUM
仕向処理通番
CHAR
8
伝送ファイルの金融機関内処理通番
伝送ファイルの金融機関内処理通番

MPN_PROCDATE
MPN処理年月日
CHAR
8
伝送ファイルのMPN取扱日
伝送ファイルのMPN取扱日

MPN_PROCTIME
MPN処理時刻
CHAR
6
ALL0
ALL0

MPN_PROCNUM
MPN処理通番
CHAR
10
ALL0
ALL0

PAYMENT
精査金額
CHAR
11
ALL0
ALL0

ORIGIN_MSG_TYPE
オリジナル電文種別コード
CHAR
4
ALL0
ALL0

ORIGIN_RES_CODE
オリジナルレスポンスコード
CHAR
4
ALL SPACE
ALL SPACE

RES_CODE
レスポンスコード
CHAR
4
ALL SPACE
ALL SPACE

AGENCY_CODE
歳入代理店金融機関コード
CHAR
8
ALL0
ALL0

CHANNEL_TYPE
チャネル区分
CHAR
2
伝送ファイルのチャネル区分
伝送ファイルのチャネル区分

PAY_TYPE
納付金区分
CHAR
2
伝送ファイルの納付金区分
伝送ファイルの納付金区分

IN_TYPE
入力区分
CHAR
2
伝送ファイルの入力区分
伝送ファイルの入力区分

OCR_INFO
OCR情報
CHAR
83
伝送ファイルの収納識別情報※1
伝送ファイルの収納識別情報※1

BARCODE_INFO
バーコード情報
VARCHAR
50
伝送ファイルの収納識別情報※2
伝送ファイルの収納識別情報※2

PAY_FORM
支払形態
CHAR
1
ALL0
ALL0

BILL_INFO
請求情報
VARCHAR
115
NULL
請求情報の設定項目内容※3

IS_INQ
照会有無
CHAR
1
ALL0
ALL0

RECEIPT_DATE
入金日
CHAR
8
伝送ファイルの入金日
伝送ファイルの入金日

CHECK_AMT
他店券金額
CHAR
11
伝送ファイルの他店券金額
伝送ファイルの他店券金額

USER_NAME_KANA
利用者名（カナ）
VARCHAR
24
NULL
NULL

USER_NAME_KANJI
利用者名（漢字）
NVARCHAR
24
NULL
NULL

RECV_NAME_KANA
収納機関名（カナ）
VARCHAR
24
NULL
NULL

RECV_NAME_KANJI
収納機関名（漢字）
NVARCHAR
24
NULL
NULL

PAY_WAY
支払方法
CHAR
1
ALL0
ALL0

STAMP_AMT
印紙税額
CHAR
3
ALL0
伝送ファイルの印紙税額

BANK_OPTION
金融機関任意情報
VARCHAR
20
伝送ファイルの金融機関任意情報
伝送ファイルの金融機関任意情報

PAY_AMT
収納金額
CHAR
11
伝送ファイルの収納金額
伝送ファイルの収納金額

PAY_DATE
収納日
CHAR
8
伝送ファイルの収納日
伝送ファイルの収納日

INQ_TIME
照会時刻
CHAR
6
ALL0
ALL0

RECEIPT_TYPE
領収区分
CHAR
1
ALL0
ALL0

PAY_INFO
納付情報
VARCHAR
132
納付情報の設定項目内容※4
NULL

PUBLIC_OPTION
地公体任意情報
VARCHAR
20
ユーザーコールバックで取得した値
（地公体任意情報）※5
ALL SPACE

CAN_FLAG
取消フラグ
CHAR
1
ALL0
ALL0

RTN_INFO
リターン情報
CHAR
8
ALL0※6
ALL0※6

合計
753
－
－

（凡例）

－：該当なし

注※1

伝送ファイルの入力区分がOCR情報の場合，収納識別情報を設定します。また，OCR情報以外の場合，ALL0を設定します。

注※2

伝送ファイルの入力区分がバーコード情報の場合，収納識別情報を設定します。また，バーコード情報以外の場合，ALL0を設定します。

注※3

請求情報の設定項目内容を表10-7に示します。

注※4

納付情報の設定項目内容を表10-8に示します。

注※5

ユーザーコールバックで地公体任意情報を設定しない場合，ALL SPACEを設定します。

注※6

DBの対象金融機関情報格納用テーブル内に登録されていない場合，通信サーバfor Billerがリターン情報を設定します。通信サーバfor Billerがこの場合に設定するリターン情報については，「8.4.4　消込情報ファイルの変換」を参照してください。

表10-7　請求情報の設定項目内容

項目名
内容
項目属性
サイズ
（単位：バイト）
設定項目内容

BILL_INFO
請求情報数
VARCHAR
2
固定値01

識別番号
20
ALL SPACE

払込書区分
1
ALL0

請求金額
11
伝送ファイルの収納金額

請求金額元金
11
伝送ファイルの請求金額元金

延滞金表示区分
1
ALL0

延滞金
8
伝送ファイルの延滞金

消費税額表示区分
1
ALL0

消費税額
10
ALL0

予備
1
ALL0

手数料負担区分
1
伝送ファイルの手数料負担区分

請求内容（カナ）
24
ALL SPACE

請求内容（漢字）
24
ALL SPACE（全角）

合計
115
－

（凡例）

－：該当なし

表10-8　納付情報の設定項目内容

項目名
内容
項目属性
サイズ
（単位：バイト）
設定項目内容

PAY_INFO
納付情報数
VARCHAR
2
固定値01

予備1
4
ALL0

識別番号
20
ユーザーコールバックで取得した値（確認番号）※

払込書区分
1
ALL0

納付合計額
11
伝送ファイルの収納金額

納付額
11
伝送ファイルの納付額

延滞金表示区分
1
ALL0

延滞金
8
伝送ファイルの延滞金

予備2
23
ALL0

手数料負担区分
1
伝送ファイルの手数料負担区分

納付内容（カナ）
24
ALL SPACE

納付内容（漢字）
24
ALL SPACE（全角）

予備3
2
ALL0

合計
132
－

（凡例）

－：該当なし

注※

左詰で設定し，残りはALL SPACEを設定します。

-o 消込情報ファイル名～<パス名>(1～PATH_MAX文字)

消込情報ファイル名を絶対パスまたは相対パスで指定します。

消込情報ファイルは，伝送ファイルを変換したDAT形式のファイルです。DBの消込情報格納用テーブルと同じ書式です。伝送ファイルは，ファイル転送によって，MPNセンタから送られます。

次に，消込情報ファイルの出力形式例を示します。消込情報ファイルの形式については，「5.6　消込情報格納用テーブルの作成」を参照してください。

地方税・地公体料金の場合

"収納機関コード","納付番号","確認番号","納付区分","仕向トランザクション番号","被仕向トランザクション番号","仕向センタコード","被仕向センタコード","金融機関コード","店舗コード","仕向処理年月日","仕向処理時刻","仕向処理通番","MPN処理年月日","MPN処理時刻","MPN処理通番","精査金額","オリジナル電文種別コード","オリジナルレスポンスコード","レスポンスコード","歳入代理店金融機関コード","チャネル区分","納付金区分","入力区分","OCR情報","バーコード情報","支払形態","請求情報","照会有無","入金日","他店券金額","利用者名（カナ）","利用者名（漢字）","収納機関名（カナ）","収納機関名（漢字）","支払方法","印紙税額","金融機関任意情報","収納金額","収納日","照会時刻","領収区分","納付情報","地公体任意情報","取消フラグ","リターン情報"

一般料金の場合

"収納機関コード","お客様番号","確認番号","","仕向トランザクション番号","被仕向トランザクション番号","仕向センタコード","被仕向センタコード","金融機関コード","店舗コード","仕向処理年月日","仕向処理時刻","仕向処理通番","MPN処理年月日","MPN処理時刻","MPN処理通番","精査金額","オリジナル電文種別コード","オリジナルレスポンスコード","レスポンスコード","歳入代理店金融機関コード","チャネル区分","納付金区分","入力区分","OCR情報","バーコード情報","支払形態","請求情報","照会有無","入金日","他店券金額","利用者名（カナ）","利用者名（漢字）","収納機関名（カナ）","収納機関名（漢字）","支払方法","印紙税額","金融機関任意情報","収納金額","収納日","照会時刻","領収区分","納付情報","地公体任意情報","取消フラグ","リターン情報"

消込情報の「お客様番号」，「確認番号」，「納付区分」および「地公体任意情報」については，ユーザーコールバックで値が取得されます。一般料金の場合，「納付区分」には「""」が設定されます。

ユーザーコールバックの作成については「6.　ユーザーコールバックの作成」を参照してください。

なお，消込情報ファイルがすでにある場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，消込情報ファイルのアクセス権の有無に関係なく，消込情報ファイルを削除し，続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

-c エラー件数～<符号なし整数>((1～10000))（単位：件）

伝送ファイルのフォーマットチェックをした際に，出力されるエラーメッセージの件数を指定できます。

このオプションを指定すると，エラーがなくなるまで，または指定した件数までエラーメッセージが出力されます。このオプションを指定しない場合，1,000件までエラーメッセージが出力されます。ただし，対象金融機関チェックで出力されるエラーメッセージは，エラー件数に含まれません。

なお，エラー件数は1レコード当たり1件とします。そのため，1レコードに複数のエラーがあるときのエラー件数は1件となります。

伝送ファイルのフォーマットチェック，および金融機関コードチェックについては，「8.4.4　消込情報ファイルの変換」を参照してください。

-dat

MPNセンタから媒体で受け取った伝送ファイルをファイル変換する場合に指定するオプションです。異常時運用の場合だけ指定してください。なお，伝送ファイルに指定された店舗コードがALL0の場合，店舗コードを無視して処理を継続します。

戻り値

0：正常終了

1：消込情報ファイルの変換の中断（消込情報ファイルがすでにあり，処理の続行を指定しない場合）

上記以外：エラーリターン

消込情報ファイルの変換の各チェックが，すべて正常に終了した場合だけ，戻り値は0になります。各チェックの一部が正常終了した場合は，戻り値は上記以外のエラーリターンです。ただし，正常終了したレコードはファイルとして出力されます。

注意

DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

消込情報ファイルの変換コマンドの実行中にエラーが発生した場合，伝送ファイルがうまく変換されないで，そのまま消込情報ファイルとして出力されることがあります。

消込情報ファイルの変換コマンド，および消込情報の出力コマンド（hmpnpaylist）を同時に複数実行した場合，必ず消込情報ファイル名を変更してください。また，この消込情報ファイル名は納付情報の一括登録コマンド（hmpnbilload），請求情報の一括登録コマンド（hmpndemload）および一括消込コマンド（hmpnpayload）を同時に実行した場合に出力される結果報告ファイル名とも重複しないように設定してください。

「-dat」オプションは，異常時運用で，MPNセンタから媒体で受け取った伝送ファイルをファイル変換する場合以外は，指定しないでください。

hmpnpayload（一括消込）

形式

HiRDB/Single Serverの場合
hmpnpayload -s 収納機関コード -f 入力情報ファイル名 [-c [エラー件数]|[[-o [-rd RDエリア名]] [-nc] [-a] [-is] [-iw インデクス情報ファイル用ディレクトリ] [-sw ソート用ワークディレクトリ [-sb ソート用バッファサイズ]]]] [-r 結果報告ファイル名]

HiRDB/Parallel Serverの場合
hmpnpayload -s 収納機関コード -f 入力情報ファイル名 {-c [エラー件数]|-sv サーバ名 [-o [-rd RDエリア名]] [-nc [-st セットアップディレクトリ]] [-a] [-is] [-iw インデクス情報ファイル用ディレクトリ] [-sw ソート用ワークディレクトリ [-sb ソート用バッファサイズ]]} [-r 結果報告ファイル名]

機能

複数の消込情報をDBへ一括登録します。また，消込情報に対応した納付情報/請求情報の消込処理を行います。

「-c」オプション，および「-nc」オプションを指定しない場合，入力情報ファイルをチェックし，DBへ一括登録します。また，この場合，出力されるエラーメッセージは1件までとなります。なお，「-c」オプションを指定する場合，エラーメッセージは指定した件数だけ表示されます。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

消込情報を登録する収納機関の収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-f 入力情報ファイル名～<パス名>(1～PATH_MAX文字)

入力情報ファイル名を絶対パス，または相対パスで指定します。「,」を含むディレクトリ，またはファイル名を指定できません。

入力情報ファイルは，消込情報を入力したDAT形式のファイルです。DBの消込情報格納用テーブルと同じ書式で，前もって作成しておきます。入力情報ファイルの形式は，消込情報ファイルの変換コマンド（hmpnpayfile）を実行した際に出力される，消込情報ファイルの形式と同様です。また，消込情報ファイルの変換コマンドを実行した際に出力される消込情報ファイルを，入力情報ファイルとして，一括消込コマンドを実行できます。

消込情報ファイルの変換，および消込情報ファイルの出力形式については「hmpnpayfile（消込情報ファイルの変換）」を参照してください。

なお，DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-c [エラー件数]～<符号なし整数>((1～10000))（単位：件）

入力情報ファイルのチェックだけを実行する場合に指定します。

このオプションでエラー件数を指定した場合，エラーがなくなるまで，または指定した件数までエラーメッセージが出力されます。また，エラー件数を指定しない場合，1,000件までエラーメッセージが出力されます。

なお，エラー件数は1レコード当たり1件とします。そのため，1レコードに複数のエラーがあるときのエラー件数は1件となります。

-sv サーバ名～＜識別子＞(1～8文字)

実行サーバ名（フロントエンドサーバ名またはバックエンドサーバ名）を指定します。このオプションは，HiRDB/Parallel Serverを使用している場合に指定してください。

また，HiRDBには，インデクス情報ファイルは，インデクス格納RDエリアがあるHiRDB/Single Server，またはバックエンドサーバに作成するという制約があります。そのため，フロントエンドサーバ名または消込情報格納用テーブルのインデクス格納RDエリアのないバックエンドサーバ名を指定する場合は，必ず「-is」オプションを指定してください。

-o [-rd RDエリア名]～<識別子>，およびSPACE(1～30文字)

通信サーバfor Billerの起動中に一括消込を実行する場合に指定します。RDエリア名を指定すると，RDエリアを閉塞し，場合によってはオンライン処理をエラーにします。RDエリア名には，通信サーバfor Billerを利用するに当たって作成した消込情報を格納するためのユーザー用RDエリア名を指定します。指定するRDエリア名が空白を含む場合，「""」で囲んでください。また，RDエリア名に"ALL"は指定できません。

また，RDエリア名を指定しない場合，RDエリアを閉塞しないで収納情報の一括登録処理をすると，収納情報の一括登録処理とオンライン処理が同じテーブルにアクセスします。そのため，どちらかの処理が，排他待ち状態になります。RDエリアについては，「付録A　HiRDBのRDエリアの見積もり方法」を参照してください。

-nc [-st セットアップディレクトリ]～<パス名>(1～PATH_MAX文字)

入力情報ファイルをチェックしないで，一括登録する場合に指定します。このオプションは，「-c」オプションで入力情報ファイルをチェックしたあと，エラーがなかった場合だけ指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，セットアップディレクトリを絶対パスで指定してください。なお，セットアップディレクトリには，実行サーバにセットアップ済みの通信サーバfor Biller，またはDB Utility for Billerのセットアップディレクトリを指定してください。

-a

納付情報または請求情報を，全件まとめて更新する場合に指定します。このオプションを指定しない場合，1件ごとに納付情報または請求情報を更新します。

このオプションを指定すると，全件まとめて更新することができるため，指定しない場合に比べて性能が向上します。なお，このオプションを指定して更新が失敗した場合には，すべての更新処理が取り消されます。

-is

インデクス作成方法として，インデクス更新モードを選択する場合に指定します。このオプションを指定すると，一括消込コマンドの内部で実行する，HiRDBのデータベース作成ユティリティ（pdload）で，インデクス更新モードが選択されます。

このオプションの指定を省略した場合は，インデクス一括作成モードでコマンドを実行します。

インデクス更新モードおよびインデクス一括作成モードについては，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-iw インデクス情報ファイル用ディレクトリ～＜パス名＞(1～255文字)

インデクス情報ファイル用ディレクトリを，絶対パスまたは相対パスで指定します。

インデクス情報ファイル用ディレクトリは，一括消込コマンドの内部で実行する，HiRDBのデータベース作成ユティリティ（pdload）のインデクス情報ファイルが作成されるディレクトリです。

ただし，HiRDB/Parallel Serverを使用している場合に，「-st」オプションでセットアップディレクトリを指定したときは，絶対パスで指定してください。また，すでに存在するディレクトリを指定してください。このオプションの指定を省略した場合は，$HMPNDIR/spool/bl/bat/idxが仮定されます。「-is」オプションを指定した場合，このオプションは無視されます。

インデクス情報ファイル用ディレクトリについては，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-sw ソート用ワークディレクトリ～＜パス名＞ [-sb ソート用バッファサイズ](128～2097152)

ソート用ワークディレクトリを，絶対パスまたは相対パスで指定します。

ソート用ワークディレクトリは，一括消込コマンドの内部で実行する，HiRDBのデータベース作成ユティリティ（pdload）のソート用ワークファイルが作成されるディレクトリです。

ただし，HiRDB/Parallel Serverを使用している場合に，「-st」オプションでセットアップディレクトリを指定したときは，絶対パスで指定してください。また，すでに存在するディレクトリを指定してください。このオプションの指定を省略した場合は，/tmpが仮定されます。

「-sb」オプションを指定すると，HiRDBのデータベース作成ユティリティ（pdload）がソートを行う際に使用するバッファのサイズ（キロバイト）を指定することができます。「-sb」オプションの指定を省略した場合は，ソート用バッファサイズとして，1,024（キロバイト）が仮定されます。

「-is」オプションを指定した場合，「-sw」オプションおよび「-sb」オプションは無視されます。

ソート用ワークディレクトリ，およびソート用バッファサイズについては，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-r 結果報告ファイル名～<英数字>(1～50文字)

結果報告ファイルを出力する場合に指定します。このオプションを指定しない場合，入力情報ファイルをチェックしても，結果報告ファイルは出力されません。

結果報告ファイルは，（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/batディレクトリに格納され，テキストファイルとして出力されます。出力されるファイルの種類，および結果報告ファイルのうち，データチェックファイルの出力形式については，「hmpnbilload（納付情報の一括登録）」を参照してください。

また，データチェックファイル，およびデータ登録ファイルの出力内容については「8.4.5　一括消込」を参照してください。

一括消込コマンドを実行した場合の結果報告ファイルのうち，データ登録ファイルの出力形式は納付情報の一括登録の場合と異なります。

消込情報を編集し，DBへの登録が失敗した場合，データ登録ファイルの最終行に失敗した登録データが出力されます。データ登録ファイルの出力形式を次に示します。

"収納機関コード","お客様番号（納付番号）","確認番号","納付区分","仕向トランザクション番号","被仕向トランザクション番号","仕向センタコード","被仕向センタコード","金融機関コード","店舗コード","仕向処理年月日","仕向処理時刻","仕向処理通番","MPN処理年月日","MPN処理時刻","MPN処理通番","精査金額","オリジナル電文種別コード","オリジナルレスポンスコード","レスポンスコード","歳入代理店金融機関コード","チャネル区分","納付金区分","入力区分","OCR情報","バーコード情報","支払形態","請求情報","照会有無","入金日","他店券金額","利用者名（カナ）","利用者名（漢字）","収納機関名（カナ）","収納機関名（漢字）","支払方法","印紙税額","金融機関任意情報","収納金額","収納日","照会時刻","領収区分","納付情報","地公体任意情報","取消フラグ","リターン情報","作成日","作成時刻"

また，結果報告ファイルがすでに出力されている場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，結果報告ファイルのアクセス権の有無に関係なく結果報告ファイルを削除し，処理は続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

戻り値

0：正常終了

1：一括消込の中断（結果報告ファイルがすでにあり，処理の続行を指定しない場合）

2：一括消込の中断（オンラインでコマンドを実行した場合）

上記以外：エラーリターン

注意

一括消込コマンドの実行中に，同じ収納機関コードで納付情報の一括登録コマンド（hmpnbilload），請求情報の一括登録コマンド（hmpndemload），および一括消込コマンドを実行できません。

一括消込コマンドを実行中にエラーが発生した場合，未完成な結果報告ファイルが出力されることがあります。

一括消込コマンド以外で結果報告ファイルを使用している場合，「-r」オプションを指定して一括消込コマンドを実行すると，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した結果報告ファイル名を変更して再度実行してください。

「-f」オプションで指定する入力情報ファイルは，「,」を含むディレクトリ，またはファイル名を指定できません。

一般料金の場合，「-f」オプションで指定する入力情報ファイルの「納付区分」には「""」を設定してください。データが設定されていると，エラーになることがあります。

「-o」オプションを指定する場合，通信サーバ管理者とHiRDB管理者が異なるときは，RDエリアを閉塞して一括登録処理を行う機能（「-rd」オプション）は使用できません。

通信サーバ稼働中にこのコマンドは実行できません。ただし，「-o」オプションを指定した場合は，通信サーバ稼働中でもこのコマンドを実行できます。

HiRDB/Parallel Serverを使用している場合に，このコマンドを実行するときは，システムマネジャのあるサーバでコマンドを実行してください。

HiRDB/Parallel Serverを使用している場合に，「-st」オプションを指定してこのコマンドを実行するときは，入力情報ファイル，インデクス情報ファイル用ディレクトリおよびソート用ワークディレクトリは，絶対パスで指定してください。入力情報ファイルを，実行サーバにFTPを使用してASCIIモードで転送する場合，転送元と同じディレクトリ配下に転送し，それを入力情報ファイル名として絶対パスで指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，実行サーバ上のセットアップディレクトリ配下に，エラー情報ファイル，データ登録ファイルおよびインデクス情報ファイルが出力されます。ただし，更新処理で失敗したケースで出力するデータ登録ファイルは，コマンド実行サーバ上に出力されます。なお，更新処理で失敗したケースを除くデータ登録ファイルがすでにある場合，コマンドがエラーになります。

インデクス情報ファイル用ディレクトリおよびソート用ワークディレクトリを指定する場合，指定したディレクトリにアクセスできることを確認した上で，コマンドを実行してください。指定したディレクトリにアクセスできない状態でコマンドを実行した場合，データベースにアクセスできなくなるおそれがあります。

hmpnpaylist（消込情報の出力）

形式

hmpnpaylist -s 収納機関コード -c 取扱日 -o 消込情報ファイル名 [-t]

機能

収納機関コードおよび取扱日を入力すると，DBから該当する消込情報レコードを検索し，ファイルとして出力します。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

消込情報レコードを出力する収納機関の，収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-c 取扱日～<符号なし整数>

出力する消込情報の取扱日を指定します。日付の形式は，yyyymmddです。必ず，存在する日付を指定してください。

-o 消込情報ファイル名<パス名>(1～PATH_MAX文字)

検索した消込情報レコードを出力するファイル名を絶対パス，または相対パスで指定します。

なお，消込情報ファイルがすでにある場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，消込情報ファイルのアクセス権の有無に関係なく，消込情報ファイルは削除されます。また，処理の続行を指定しないと，処理は中断されます。

-t

検索する取扱日の対象を変更する場合に指定します。このオプションを指定すると，MPN処理年月日を取扱日として，チャネル区分が一括伝送方式の消込情報レコードを検索します。オプションを指定しない場合は，仕向処理年月日を取扱日として，チャネル区分が一括伝送方式以外の消込情報レコードを検索します。

出力形式

消込情報ファイルは，バイナリ形式のファイルです。消込情報レコードがテーブルに登録されている順に出力されます。

戻り値

0：正常終了

1：消込情報の出力の中断（消込情報ファイルがすでにあり，処理の続行を指定しない場合）

3：消込情報の出力の中断（DBに該当する消込情報レコードがない場合）

上記以外：エラーリターン

注意

消込情報の出力コマンドが失敗して，消込情報ファイルが出力されている場合，検索に成功した最終行までとなります。

消込情報の出力コマンドの実行中にエラーが発生した場合，DBから該当する消込情報レコードを検索した内容が，正しい消込情報ファイルとして出力されないことがあります。

消込情報の出力コマンド以外で，消込情報ファイルを使用している場合，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した消込情報ファイル名を変更し再度実行してください。

hmpnbnkctl（金融機関情報の変更）

形式

HiRDB/Single Serverの場合
hmpnbnkctl -s 収納機関コード {-a -f 入力情報ファイル名 [-r 結果報告ファイル名] [-c [エラー件数]]|-d}

HiRDB/Parallel Serverの場合
hmpnbnkctl -s 収納機関コード {-a -f 入力情報ファイル名 [-r 結果報告ファイル名] {-sv サーバ名 [-nc [-st セットアップディレクトリ]]|-c [エラー件数]}|-d}

機能

金融機関情報を追加登録，または削除します。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

金融機関情報を追加登録，または削除する収納機関の収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-a

金融機関情報を追加登録する場合に指定します。

-f 入力情報ファイル名～<パス名>(1～PATH_MAX文字)

入力情報ファイル名を絶対パス，または相対パスで指定します。

入力情報ファイルは，金融機関情報を入力したDAT形式のファイルです。DBの対象金融機関情報格納用テーブルと同じ書式をテキストファイルで，前もって作成しておきます。入力情報ファイルの形式を次に示します。また，これらの項目はすべてオンライン処理に必要です。表にある桁数，および属性の範囲でMPNの仕様に基づき作成してください。

なお，通信サーバfor BillerはRECV_CODE以外を検索対象とします。そのため，RECV_CODE以外の項目は必ず指定してください。

表10-9　入力情報ファイルの形式（金融機関情報：地方税・地公体料金，一般料金の場合）

項目名 | 内容 | 桁数 | 属性
RECV_CODE | 収納機関コード | 8 | n
TAX_CLS※1，※2 | 税目・料金番号 | 3 | n
BANK_CODE※1，※3 | 金融機関コード | 8 | n
BRANCH_CODE※1，※3 | 店舗コード，または法人などで使用する仮想の店舗コード | 6 | n
CHANNEL_TYPE※1，※3 | チャネル区分 | 2 | n
START_DATE※4 | 適用開始年月日 | 8 | n
STOP_DATE※4 | 適用終了年月日 | 8 | n

（凡例）

n：数字

注※1

地方税・地公体料金の場合，これらの項目に指定したデータの組み合わせは，ほかのデータと重複しないように指定してください。また，TAX_CLSに共通コードを指定する場合は，ALL0を指定してください。

注※2

一般料金の場合，税目・料金番号には「NULL」を指定します。DAT形式のため，「""」と指定してください。データが指定されていると，エラーになることがあります。

注※3

一般料金の場合，これらの項目に指定したデータの組み合わせは，ほかのデータと重複しないように指定してください。

注※4

収納委託契約がない金融機関を指定する場合は，適用開始年月日，および適用終了年月日にALL0を指定してください。

収納委託契約がある金融機関を指定する場合は，適用開始年月日にALL0，適用終了年月日にALL9を指定してください。

また，これらのファイルはDAT形式のため，作成する場合は次の点に注意してください。

各項目のデータは，SJISコードで指定してください。

各項目のデータを必ず「""」で囲んでください。

「""」で囲む中にデータを指定していないと，NULLと同じように処理されます。この項目の属性がVARCHAR，またはNVARCHARのとき，長さは0になります。

各項目は，「,」で区切ってください。データの中の「,」は，データとして処理されます。

表10-10　入力情報ファイルの形式（金融機関情報：国庫金の場合）

項目名 | 内容 | 桁数 | 属性
RECV_CODE | 収納機関コード | 8 | n
PAY_CLS※1.，※2 | 納付区分 | 16 | n
AGENCY_CODE※1 | 歳入代理店金融機関コード | 8 | n
BRANCH_CODE※1 | 店舗コード | 6 | n
CHANNEL_TYPE※1 | チャネル区分 | 2 | n
START_DATE | 適用開始年月日 | 8 | n
STOP_DATE | 適用終了年月日 | 8 | n
PROD_DATE | 作成日 | 8 | n
PROD_TIME | 作成時刻 | 6 | n

（凡例）

n：数字

注※1

ユニークインデクスで指定されています。これらの項目に指定したデータの組み合わせは，ほかのデータと重複しないように指定してください。

注※2

国庫金で収納機関コードが国税庁（00200000）以外の場合は，入力情報ファイルに「""」を指定します。この項目は，一般料金同様，最大桁数を超えた場合だけエラーになります。

入力情報ファイルの形式例を次に示します。入力情報ファイルは，収納機関ごとに作成してください。

地方税・地公体料金の場合

"収納機関コード","税目・料金番号","金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

一般料金の場合

"収納機関コード","","金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

国庫金で収納機関コードが国税庁（00200000）の場合

"収納機関コード","納付区分","歳入代理店金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

国庫金で収納機関コードが国税庁（00200000）以外の場合

"収納機関コード","","歳入代理店金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

注

作成日，および作成時刻は，通信サーバfor Billerがデータを作成および編集します。

なお，DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-r 結果報告ファイル名～<英数字>(1～50文字)

結果報告ファイルを出力する場合に指定します。このオプションを指定しない場合，入力情報ファイルをチェックしても，結果報告ファイルは出力されません。

結果報告ファイルは，（通信サーバfor Billerのセットアップディレクトリ）/spool/bl/batディレクトリに格納され，テキストファイルとして出力されます。

出力されるファイルの種類を次に示します。

表10-11　結果報告ファイルの種類（金融機関情報の変更）

指定したオプション | 出力されるファイルの種類
-r | -c | データチェックファイル（結果報告ファイル名.chk）
-a | データ登録ファイル（結果報告ファイル名.rlt）

データチェックファイル，およびデータ登録ファイルの出力内容については，「8.4.7　金融機関情報の変更」を参照してください。

また，結果報告ファイルのうち，データチェックファイルの出力形式については，「hmpnbilload（納付情報の一括登録）」を参照してください。

金融機関情報の変更コマンドを実行した場合の結果報告ファイルのうち，データ登録ファイルの出力形式は納付情報の一括登録の場合と異なります。

金融機関情報を編集し，DBへの登録が失敗した場合，データ登録ファイルの最終行に失敗した登録データが出力されます。データ登録ファイルの出力形式を次に示します。

地方税・地公体料金の場合

"収納機関コード","税目・料金番号","金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日","作成日","作成時刻"

一般料金の場合

"収納機関コード","","金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日","作成日","作成時刻"

国庫金で収納機関コードが国税庁（00200000）の場合

"収納機関コード","納付区分","歳入代理店金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

国庫金で収納機関コードが国税庁（00200000）以外の場合

"収納機関コード","","歳入代理店金融機関コード","店舗コード","チャネル区分","適用開始年月日","適用終了年月日"

また，結果報告ファイルがすでに出力されている場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，結果報告ファイルのアクセス権の有無に関係なく結果報告ファイルを削除し，処理は続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

-sv サーバ名～<識別子>(1～8文字)

実行サーバ名（フロントエンドサーバ名またはバックエンドサーバ名）を指定します。このオプションは，HiRDB/Parallel Serverを使用している場合に指定してください。

-nc [-st セットアップディレクトリ]～<パス名>(1～PATH_MAX文字)

入力情報ファイルをチェックしないで，一括登録する場合に指定します。このオプションは，「-c」オプションで入力情報ファイルをチェックしたあと，エラーがなかった場合だけ指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，セットアップディレクトリを絶対パスで指定してください。なお，セットアップディレクトリには，実行サーバにセットアップ済みの通信サーバfor Biller，またはDB Utility for Billerのセットアップディレクトリを指定してください。

-c [エラー件数]～<符号なし整数>((1～10000))（単位：件）

入力情報ファイルのチェックだけを実行する場合に指定します。

このオプションでエラー件数を指定した場合，エラーがなくなるまで，または指定した件数までエラーメッセージが出力されます。また，エラー件数を指定しない場合，1,000件までエラーメッセージが出力されます。

なお，エラー件数は1レコード当たり1件とします。そのため，1レコードに複数のエラーがあるときのエラー件数は1件となります。

-d

金融機関情報を削除する場合に指定します。指定した収納機関の金融機関情報が削除されます。

戻り値

0：正常終了

1：金融機関情報の変更の中断（結果報告ファイルがすでにあり，処理の続行を指定しない場合）

2：金融機関情報の変更の中断（オンラインでコマンドを実行した場合）

上記以外：エラーリターン

注意

金融機関情報の変更コマンドの実行中に，同じ収納機関コードで金融機関情報の変更コマンドを実行できません。

通信サーバ起動中にこのコマンドを実行できません。

「-r」オプションを指定して金融機関情報の変更コマンドの実行中にエラーが発生した場合，未完成な結果報告ファイルが出力されることがあります。

金融機関情報の変更コマンド以外で結果報告ファイルを使用している場合，「-r」オプションを指定して金融機関情報の変更コマンドを実行すると，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した結果報告ファイル名を変更し再度実行してください。

「-f」オプションで指定する入力情報ファイルには，「,」を含むディレクトリ，またはファイル名を指定できません。

法人などの店舗を持たない金融機関情報を登録する場合，仮想店舗コードとして，入力情報ファイルの店舗コードに設定してください。

HiRDB/Parallel Serverを使用している場合に，このコマンドを実行するときは，システムマネジャのあるサーバでコマンドを実行してください。

HiRDB/Parallel Serverを使用している場合に，「-st」オプションを指定してこのコマンドを実行するときは，入力情報ファイルは絶対パスで指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，実行サーバ上のセットアップディレクトリ配下にエラー情報ファイルおよびデータ登録ファイルが出力されます。なお，データ登録ファイルがすでにある場合，コマンドがエラーになります。

hmpnrcvctl（収納機関情報の変更）

形式

HiRDB/Single Serverの場合
hmpnrcvctl -s 収納機関コード {-a -f 入力情報ファイル名 [-c]|-d} [-r 結果報告ファイル名]

HiRDB/Parallel Serverの場合
hmpnrcvctl -s 収納機関コード {-a -f 入力情報ファイル名 {-sv サーバ名 [-nc [-st セットアップディレクトリ]]|-c}|-d} [-r 結果報告ファイル名]

機能

収納機関情報を追加登録，または削除します。

オプション

-s 収納機関コード～<符号なし整数>((00000000～99999999))

追加登録，または削除する収納機関情報に該当する収納機関コードを指定します。収納機関コードには通信サーバシステム定義に定義した収納機関コードを指定してください。

-a

収納機関情報を追加登録する場合に指定します。

-f 入力情報ファイル名～<パス名>(1～PATH_MAX文字)

入力情報ファイル名を絶対パス，または相対パスで指定します。

入力情報ファイルは，収納機関情報を入力したDAT形式のファイルです。DBの対象収納機関情報格納用テーブルと同じ書式をテキストファイルで，前もって作成しておきます。入力情報ファイルの形式を次に示します。また，これらの項目はすべてオンライン処理に必要です。表にある桁数，および属性の範囲でMPNの仕様に基づき作成してください。

表10-12　入力情報ファイルの形式（収納機関情報）

項目名 | 内容 | 桁数 | 属性
RECV_CODE※ | 収納機関コード | 8 | n
RECV_NAME_KANA | 収納機関名（カナ） | 1～24 | ank
RECV_NAME_KANJI | 収納機関名（漢字） | 1～12 | K

（凡例）

n：《数字》

ank：《英字》，《数字》，《カナ》，《記号》，《カナ記号》，およびSPACE

K：《全角文字》

注※

収納機関コードが重複しないように指定してください。

また，これらのファイルはDAT形式のため，作成する場合は次の点に注意してください。

各項目のデータは，SJISコードで指定してください。

各項目のデータを必ず「""」で囲んでください。

「""」で囲む中にデータを指定していないと，NULLと同じように処理されます。この項目の属性がVARCHAR，またはNVARCHARのとき，長さは0になります。

各項目は，「,」で区切ってください。データの中の「,」は，データとして処理されます。

入力情報ファイルの形式例を次に示します。また，作成日，および作成時刻は，通信サーバfor Billerがデータを作成および編集します。

"収納機関コード","収納機関名（カナ）","収納機関名（漢字）"

なお，DAT形式については，マニュアル「スケーラブルデータベースサーバ HiRDB コマンドリファレンス」を参照してください。

-sv サーバ名～<識別子>(1～8文字)

実行サーバ名（フロントエンドサーバ名またはバックエンドサーバ名）を指定します。このオプションは，HiRDB/Parallel Serverを使用している場合に指定してください。

-nc [-st セットアップディレクトリ]～<パス名>(1～PATH_MAX文字)

入力情報ファイルをチェックしないで，一括登録する場合に指定します。このオプションは，「-c」オプションで入力情報ファイルをチェックしたあと，エラーがなかった場合だけ指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，セットアップディレクトリを絶対パスで指定してください。なお，セットアップディレクトリには，実行サーバにセットアップ済みの通信サーバfor Billerまたは，DB Utility for Billerのセットアップディレクトリを指定してください。

-c

入力情報ファイルのチェックだけを実行する場合に指定します。

-d

収納機関情報を削除する場合に指定します。指定した収納機関コードの収納機関情報が削除の対象となります。

-r 結果報告ファイル名～<英数字>(1～50文字)

結果報告ファイルを出力する場合に指定します。このオプションを指定しない場合，入力情報ファイルをチェックしても，結果報告ファイルは出力されません。

結果報告ファイルは，（通信サーバfor Billerセットアップディレクトリ）/spool/bl/batディレクトリに格納され，テキストファイルとして出力されます。

出力されるファイルの種類を次に示します。

表10-13　結果報告ファイルの種類（収納機関情報の変更）

指定したオプション | 出力されるファイルの種類
-r | -c | データチェックファイル（結果報告ファイル名.chk）
-a | データ登録ファイル（結果報告ファイル名.rlt）
-d | データ削除ファイル（結果報告ファイル名.rlt）

データチェックファイル，データ登録ファイル，およびデータ削除ファイルの出力内容については「8.4.8　収納機関情報の変更」を参照してください。

また，結果報告ファイルのうち，データチェックファイルの出力形式については，「hmpnbilload（納付情報の一括登録）」を参照してください。

収納機関情報の変更コマンドを実行した場合の結果報告ファイルのうち，データ登録ファイルの出力形式を次に示します。

"収納機関コード","収納機関名（カナ）","収納機関名（漢字）","作成日","作成時刻"

収納機関情報を編集し，DBへの登録が失敗した場合，データ登録ファイルの最終行に失敗した登録データが出力されます。

また，結果報告ファイルがすでに出力されている場合，処理を続行するかどうかの問い合わせがあります。処理の続行を指定すると，結果報告ファイルのアクセス権の有無に関係なく結果報告ファイルを削除し，処理は続行されます。結果報告ファイルではないものを指定した場合も，同じように削除して続行されます。この場合，指定したファイルはすべて削除されるため，注意してください。また，処理の続行を指定しないと，処理は中断されます。

次に，データ削除ファイルの出力形式について示します。

【英語：LANG=C】

KDMQCD677-I Receipt institution information was deleted. table=表名, receipt-code=収納機関コード

【日本語：LANG=Ja_JP（AIX 5Lの場合），LANG=ja_JP.SJIS（HP-UXの場合）】

KDMQCD677-I 収納機関情報を削除しました。表名＝表名，収納機関コード＝収納機関コード

戻り値

0：正常終了

1：収納機関情報の変更の中断（結果報告ファイルがすでにあり，処理の続行を指定しない場合）

2：収納機関情報の変更の中断（オンラインでコマンドを実行した場合）

上記以外：エラーリターン

注意

収納機関情報の変更コマンドの実行中に，収納機関情報の変更コマンドを実行できません。

通信サーバ起動中にこのコマンドを実行できません。

「-r」オプションを指定して収納機関情報の変更コマンドの実行中にエラーが発生した場合，未完成な結果報告ファイルが出力されることがあります。

収納機関情報の変更コマンド以外で結果報告ファイルを使用している場合，「-r」オプションを指定して金融機関情報の変更コマンドを実行すると，エラーになります。エラーが発生した場合，一定の時間を空けて再度実行するか，または，指定した結果報告ファイル名を変更し再度実行してください。

「-f」オプションで指定する入力情報ファイルには，「,」を含むディレクトリ，またはファイル名を指定できません。

HiRDB/Parallel Serverを使用している場合に，このコマンドを実行するときは，システムマネジャのあるサーバでコマンドを実行してください。

HiRDB/Parallel Serverを使用している場合に，「-st」オプションを指定してこのコマンドを実行するときは，入力情報ファイルは絶対パスで指定してください。

HiRDB/Parallel Serverを使用している場合に，システムマネジャと実行サーバ（フロントエンドサーバまたはバックエンドサーバ）が別のユニットにあるときは，実行サーバ上のセットアップディレクトリ配下にエラー情報ファイルおよびデータ登録ファイルが出力されます。なお，データ登録ファイルがすでにある場合，コマンドがエラーになります。

hmpnblinit（ファイル初期化）

形式

hmpnblinit {-f|-b}

機能

通信サーバfor Billerの動作に必要な初期化処理をします。

このコマンドは，通信サーバシステム定義を作成したあと，実行してください。

オプション

-f

通信サーバfor Billerの動作に必要な，次に示す初期化処理をします。このオプションは，必ずボリュームグループがアクティブな状態で指定してください。また，HA構成ではない場合も，「-b」オプションではなく「-f」オプションを指定してください。

状態管理ファイルの初期化

ロウ論理ボリュームへのシンボリックリンクの作成

所定のディレクトリ（通信サーバfor Billerのセットアップディレクトリ）/usrlibにライブラリがない場合，通信サーバfor Biller用のユーザーコールバックのライブラリを所定のディレクトリにコピー

通信サーバシステム定義の「CLUSTER_MODE」が「Y」の場合に，状態管理情報格納用テーブルに初期値を設定※

なお，ボリュームグループについては，「3.4.5　ロウ論理ボリュームの作成」を参照してください。また，ユーザーコールバックのライブラリについては，「6.　ユーザーコールバックの作成」を参照してください。

注※

クラスタ構成の場合，一つでも通信サーバが起動していると，状態管理情報格納用テーブルを初期化できません。状態管理情報格納用テーブルを初期化するときは，通信サーバが停止している状態でファイル初期化コマンドを実行してください。

-b

「-f」オプションと同様に，通信サーバfor Billerの動作に必要な初期化処理をします。ただし，状態管理ファイルの初期化処理はできません。HA構成の予備系で動作環境を初期化する場合，指定してください。

なお，このオプションは，ボリュームグループが非アクティブな状態での実行を前提としています。

戻り値

0：正常終了

0以外：エラーリターン

注意

ファイルの内容を初期化し，コマンドが正常終了した場合，ファイルの内容を元に戻すことはできません。なお，強制停止のあとにファイル初期化コマンドを実行した場合，通信サーバfor Billerの起動コマンド（hmpnstart）に「-R」オプションを指定して実行しても，状態を回復できません。

通信サーバシステム定義を変更した場合は，必ずファイル初期化コマンドを実行して初期化してください。初期化しなかった場合，業務系SPPが起動できないことがあります。

ロウ論理ボリュームを再構築した場合，ファイル初期化コマンドを実行して初期化する必要があります。初期化しないと，通信サーバfor Billerが起動できない場合があります。
ロウ論理ボリュームの作成については，「3.4.5　ロウ論理ボリュームの作成」を参照してください。

ファイル初期化コマンドによるユーザーコールバックのライブラリのコピーは，独自に作成したライブラリを，通信サーバfor Billerが提供するライブラリに変更する場合に使用します。その場合，所定のディレクトリから独自に作成したライブラリを削除したあとにファイル初期化コマンドを実行します。ライブラリがすでに所定のディレクトリにある場合，ファイル初期化コマンドを実行しても，既存のライブラリは上書きされません。ユーザーコールバックのライブラリについては，「6.　ユーザーコールバックの作成」を参照してください。

通信サーバ起動中にこのコマンドを実行できません。

このコマンドを実行する前に，通信サーバfor Billerのセットアップを終了しておいてください。

このコマンドを実行する前に，状態管理ファイル用ロウ論理ボリューム・業務系プロセス状態ファイル用ロウ論理ボリュームを作成しておいてください。

通信サーバシステム定義の「RAW_BL_STAT」および「RAW_WORKPRC_STAT」に正しいパスを定義しておいてください。

hmpnsetup（セットアップ）

形式

hmpnsetup {-s セットアップディレクトリ -T OpenTP1セットアップディレクトリ|-d -s セットアップディレクトリ}

機能

通信サーバfor Billerをセットアップ，またはアンセットアップします。

オプション

-s セットアップディレクトリ

通信サーバfor Billerをセットアップするディレクトリを絶対パスで指定してください。

-T OpenTP1セットアップディレクトリ

OpenTP1がセットアップされているディレクトリを絶対パスで指定してください。

-d

アンセットアップする場合に指定してください。

戻り値

0：正常終了

0以外：エラーリターン

付録

＜この付録の構成＞

付録A　HiRDBのRDエリアの見積もり方法

付録B　制御ヘッダー部のフォーマット

付録C　消込処理でのエラー内容

付録D　DB Utility for Biller

付録E　用語解説

付録A　HiRDBのRDエリアの見積もり方法

通信サーバfor Billerのオンライン機能で利用する電文履歴，収納カウンタ情報，納付情報，請求情報，消込情報，金融機関情報，収納機関情報，不正電文情報，および状態管理情報をHiRDBに格納するには，次のユーザー用RDエリアが必要です。

電文履歴を格納するためのユーザー用RDエリア

収納カウンタ情報を格納するためのユーザー用RDエリア

納付情報を格納するためのユーザー用RDエリア

請求情報を格納するためのユーザー用RDエリア

消込情報を格納するためのユーザー用RDエリア

取引対象となる金融機関一覧を格納するためのユーザー用RDエリア

業務を行う収納機関一覧を格納するためのユーザー用RDエリア

電文履歴として取得されずに破棄される電文を，不正電文情報として格納するためのユーザー用RDエリア

クラスタ構成を利用する場合，開閉局制御の状態管理情報を格納するためのユーザー用RDエリア

ここでは，ユーザー用RDエリアの算出方法と算出例を説明します。

なお，RDエリアの計算式の詳細については，マニュアル「スケーラブルデータベースサーバ HiRDB システム導入・設計ガイド」を参照してください。

＜この節の構成＞

付録A.1　電文履歴を格納するためのユーザー用RDエリアの算出方法

付録A.2　収納カウンタ情報を格納するためのユーザー用RDエリアの算出方法

付録A.3　納付情報を格納するためのユーザー用RDエリアの算出方法

付録A.4　請求情報を格納するためのユーザー用RDエリアの算出方法

付録A.5　消込情報を格納するためのユーザー用RDエリアの算出方法

付録A.6　金融機関情報を格納するためのユーザー用RDエリアの算出方法

付録A.7　収納機関情報を格納するためのユーザー用RDエリアの算出方法

付録A.8　不正電文情報を格納するためのユーザー用RDエリアの算出方法

付録A.9　状態管理情報を格納するためのユーザー用RDエリアの算出方法

付録A.1　電文履歴を格納するためのユーザー用RDエリアの算出方法

通信サーバfor BillerとMPNセンタとの間で送受信した依頼電文および応答電文の履歴情報をDBに格納するために，次の電文履歴格納用テーブルの格納領域を用意します。

テーブルの種別 | テーブル名
電文履歴格納用テーブル | HMPNHyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

ユーザー用RDエリアは，ほかのテーブルと合わせて一つの領域を確保することもできますが，テーブルごとに異なる領域を確保することもできます。ただし，MPNセンタと電文を送受信するごとに情報が増加するため，電文履歴格納用テーブルとそのほかのテーブルの格納領域を別に確保することを推奨します。

ユーザー用RDエリアは次の計算式から算出します。

ユーザー用RDエリア（バイト）＝電文履歴のレコード数（レコード）×平均電文長（バイト）×1.25

次に，電文履歴のレコード数，および平均電文長の考え方について説明します。

＜この項の構成＞

(1)　電文履歴のレコード数

(2)　平均電文長

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　電文履歴のレコード数

電文履歴は，照会サービス，消込サービス，取消サービスおよび再送確認サービスの各電文種別に関係なく，電文ごとに，次のようなタイミングで合計2回取得されます。

図A-1　電文履歴を取得するタイミング（照会依頼電文の場合）

電文種別に関係なく，1日にどれくらいの電文数が処理されるかによって，電文履歴のレコード数が決まります。

次に，電文履歴のレコード数の計算式を示します。

各サービスの電文処理数（単位：件）：a

電文履歴のレコード数の計算式

電文履歴のレコード数（レコード）＝a×2

(2)　平均電文長

電文履歴格納用テーブルの1レコード当たりの最大サイズは，5,443バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。ただし，電文履歴格納用テーブルの項目には，VARCHAR型の可変長項目であるMPN電文のデータ部が含まれるため，この部分に電文種別ごとの平均値を採用することで，用意するユーザー用RDエリアの見積もり量を抑えることができます。

次に，平均電文長の計算式を示します。なお，取消依頼電文（国庫金の場合，国庫金取消依頼電文），取消応答電文（国庫金の場合，国庫金取消応答電文），再送確認通知電文（国庫金の場合，国庫金再送確認通知電文），および再送確認応答電文（国庫金再送確認応答電文）の割合は無視できるほど小さいため，平均電文長の計算式には含めません。

電文種別ごとの平均値（単位：バイト）

照会依頼電文：b

照会応答電文：c

消込依頼電文（国庫金の場合，国庫金消込依頼電文）：d

消込応答電文（国庫金の場合，国庫金消込応答電文）：e

平均電文長の計算式

平均電文長（バイト）＝（b＋c＋d＋e）÷4

(3)　ユーザー用RDエリアの計算式

（1）および（2）で算出した値を利用して，電文履歴格納用テーブルのユーザー用RDエリアを算出します。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝a×2×（b＋c＋d＋e）÷4×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

毎日の収納サービス用に，電文トラフィックが10万件程度ある。電文種別ごとの平均値から算出した平均電文長は，600バイトである。また，各種電文履歴は7日間保存できるようにする。

この場合のユーザー用RDエリアの計算式を次に示します。

100,000（件）×2（レコード）×600（バイト）×7（日）×1.25＝1,050,000,000（バイト）

付録A.2　収納カウンタ情報を格納するためのユーザー用RDエリアの算出方法

収納カウンタ情報をDBに格納するために，次の収納カウンタ情報格納用テーブルの格納領域を用意します。なお，このテーブルは，通信サーバfor Billerに一つだけ必要です。

テーブルの種別 | テーブル名
収納カウンタ情報格納用テーブル | HMPNC00000000

なお，収納カウンタ情報格納用テーブルだけを格納するユーザー用RDエリアを一つ確保することもできますが，そのほかのユーザー用RDエリアとまとめて確保することもできます。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝収納カウンタ情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，収納カウンタ情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　収納カウンタ情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　収納カウンタ情報のレコード数

収納カウンタ情報は，通信サーバfor Billerの閉局時または収納カウンタ情報取得コマンド（hmpncntget）実行時に，次のようなタイミングで1回だけ取得されます。

図A-2　収納カウンタ情報を取得するタイミング（通信サーバfor Billerの閉局時）

閉局時にMPNセンタから通知される収納カウンタ情報には，当日分と前日分の2日分の情報を含みますが，2日分の情報が1レコードとして記録されます。

次に，収納カウンタ情報のレコード数の計算式を示します。

収納カウンタ情報取得コマンドの実行回数および閉局する回数（単位：回）

収納カウンタ情報取得コマンドの実行回数：a

閉局する回数：b

収納カウンタ情報のレコード数の計算式

収納カウンタ情報のレコード数（レコード）＝a＋b

(2)　1レコード当たりの最大サイズ

収納カウンタ情報格納用テーブルの1レコード当たりの最大サイズは，144バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。

(3)　ユーザー用RDエリアの計算式

（1）で算出した値，および（2）の1レコード当たりの最大サイズを利用して，収納カウンタ情報格納用テーブルのユーザー用RDエリアを算出します。収納カウンタ情報格納用テーブルの項目には，可変長項目は含まれません。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝（a＋b）×144×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

毎日1回閉局処理を実行する。閉局処理を実行する前に，明示的に収納カウンタ情報取得コマンドを実行して当日の収納カウンタ情報を取得する。収納カウンタ情報は90日間保存できるようにする。

この場合のユーザー用RDエリアの計算式を次に示します。

（1（回）＋1（回））×144（バイト）×90（日）×1.25＝32,400（バイト）

付録A.3　納付情報を格納するためのユーザー用RDエリアの算出方法

納付情報をDBに格納するために，次のテーブルの格納領域を用意します。

収納サービスの種類 | テーブルの種別 | テーブル名
地方税・地公体料金，一般料金 | 納付情報格納用テーブル | HMPNNyyyyyyyy
国庫金 | 国庫金納付情報格納用テーブル | HMPNTyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

ユーザー用RDエリアは，ほかのテーブルと合わせて一つの領域を確保することもできますが，テーブルごとに異なる領域を確保することもできます。ただし，オンライン電文によって納付情報の追加および削除を頻繁に行う場合は，納付情報格納用テーブルまたは国庫金納付情報格納用テーブルと，そのほかのテーブルの格納領域を別に確保することを推奨します。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝納付情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，納付情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　納付情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　納付情報のレコード数

地方税・地公体料金，および一般料金の場合，納付情報は次のようなタイミングで取得されます。なお，国庫金の場合，納付情報取得のタイミングはユーザー任意となります。

図A-3　納付情報を登録するタイミング（オンラインの場合）

1日に登録される納付情報の件数によって，納付情報のレコード数が決まります。

次に，納付情報のレコード数の計算式を示します。

納付情報の登録件数（単位：件）

1日に一括登録される納付情報件数：a

1日にオンライン電文で登録される納付情報件数：b

納付情報のレコード数の計算式

納付情報のレコード数（レコード）＝a＋b

(2)　1レコード当たりの最大サイズ

各テーブルの1レコード当たりの最大サイズを次に示します。

納付情報格納用テーブル：1,488バイト

国庫金納付情報格納用テーブル：1,502バイト

ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。なお，これらのテーブルには可変長項目が含まれていますが，全体サイズに大きな影響はありません。

(3)　ユーザー用RDエリアの計算式

（1）で算出した値，および（2）の1レコード当たりの最大サイズを利用して，各テーブルのユーザー用RDエリアを算出します。

次に各テーブルのユーザー用RDエリアの計算式を示します。

納付情報格納用テーブルの場合

ユーザー用RDエリア（バイト）＝（a＋b）×1,488×1.25

国庫金納付情報格納用テーブルの場合

ユーザー用RDエリア（バイト）＝（a＋b）×1,502×1.25

(4)　算出例

納付情報格納用テーブルのユーザー用RDエリアの算出例を次に示します。

（例）

1日に1回，10,000件の納付情報を一括登録する。また，オンラインで1日に2,000件の追加登録をする。納付情報は平均有効期限を7日間とする。

この場合のユーザー用RDエリアの計算式を次に示します。

（10,000（件）＋2,000（件））×7（日）×1,488（バイト）×1.25＝156,240,000（バイト）

付録A.4　請求情報を格納するためのユーザー用RDエリアの算出方法

請求情報をDBに格納するために，次の請求情報格納用テーブルの格納領域を用意します。

テーブルの種別 | テーブル名
請求情報格納用テーブル | HMPNSyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

ユーザー用RDエリアは，ほかのテーブルと合わせて一つの領域を確保することもできますが，テーブルごとに異なる領域を確保することもできます。ただし，オンライン電文によって請求情報の追加および削除を頻繁に行う場合は，請求情報格納用テーブルとそのほかのテーブルの格納領域を別に確保することを推奨します。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝請求情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，請求情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　請求情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　請求情報のレコード数

請求情報は，次のようなタイミングで取得されます。

図A-4　請求情報を登録するタイミング（オンラインの場合）

1日に登録される請求情報の件数によって，請求情報のレコード数が決まります。

次に，請求情報のレコード数の計算式を示します。

請求情報の登録件数（単位：件）

1日に一括登録される請求情報件数：a

1日にオンライン電文で登録される請求情報件数：b

請求情報のレコード数の計算式

請求情報のレコード数（レコード）＝a＋b

(2)　1レコード当たりの最大サイズ

請求情報格納用テーブルの1レコード当たりの最大サイズは，1,440バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。なお，このテーブルには可変長項目が含まれていますが，全体サイズに大きな影響はありません。

(3)　ユーザー用RDエリアの計算式

（1）で算出した値，および（2）の1レコード当たりの最大サイズを利用して，請求情報格納用テーブルのユーザー用RDエリアを算出します。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝（a＋b）×1,440×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

1日に1回，10,000件の請求情報を一括登録する。また，オンラインで1日に2,000件の追加登録をする。請求情報は平均有効期限を7日間とする。

この場合のユーザー用RDエリアの計算式を次に示します。

（10,000（件）＋2,000（件））×7（日）×1,440（バイト）×1.25＝151,200,000（バイト）

付録A.5　消込情報を格納するためのユーザー用RDエリアの算出方法

消込情報をDBに格納するために，次のテーブルの格納領域を用意します。

収納サービスの種類 | テーブルの種別 | テーブル名
地方税・地公体料金，一般料金 | 消込情報格納用テーブル | HMPNKyyyyyyyy
国庫金 | 国庫金消込情報格納用テーブル | HMPNKyyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

ユーザー用RDエリアは，ほかのテーブルと合わせて一つの領域を確保することもできますが，テーブルごとに異なる領域を確保することもできます。ただし，MPNセンタから消込依頼電文（国庫金の場合，国庫金消込依頼電文）を受信するごとに情報が増加するため，消込情報格納用テーブルまたは国庫金消込情報格納用テーブルと，そのほかのテーブルの格納領域を別に確保することを推奨します。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝消込情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，消込情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　消込情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　消込情報のレコード数

消込情報は，次のようなタイミングで取得されます。

図A-5　消込情報を登録するタイミング（オンラインの場合）

1日に受信する消込依頼電文（国庫金の場合は，国庫金消込依頼電文）の件数によって，取得する消込情報のレコード数が決まります。

消込情報の登録件数（単位：件）

1日に一括登録される消込情報件数：a

1日にオンライン電文で登録される消込情報件数：b

消込情報のレコード数

消込情報のレコード数（レコード）＝a＋b

(2)　1レコード当たりの最大サイズ

消込情報格納用テーブルまたは国庫金消込情報格納用テーブルの1レコード当たりの最大サイズは，760バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。なお，これらのテーブルには可変長項目が含まれていますが，全体サイズに大きな影響はありません。

(3)　ユーザー用RDエリアの計算式

（1）および（2）の値を利用して，消込情報格納用テーブルまたは国庫金消込情報格納用テーブルのユーザー用RDエリアを算出します。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝（a＋b）×760×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

毎日の収納サービス用に，電文トラフィックが100,000件程度ある。各電文種別の割合は，照会サービスが約40%，消込サービスが60%で，取消サービスはほとんど発生しないとする。

この場合のユーザー用RDエリアの計算式を次に示します。

100,000（件）×0.6×760（バイト）×1.25＝57,000,000（バイト）

付録A.6　金融機関情報を格納するためのユーザー用RDエリアの算出方法

金融機関情報をDBに格納するために，次のテーブルの格納領域を用意します。

収納サービスの種類 | テーブルの種別 | テーブル名
地方税・地公体料金，一般料金 | 対象金融機関情報格納用テーブル | HMPNByyyyyyyy
国庫金 | 国庫金対象金融機関情報格納用テーブル | HMPNByyyyyyyy

（凡例）

yyyyyyyy：収納機関コード

ユーザー用RDエリアは，ほかのテーブルと合わせて一つの領域を確保することもできますが，テーブルごとに異なる領域を確保することもできます。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝金融機関情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，金融機関情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　金融機関情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　金融機関情報のレコード数

金融機関情報は，金融機関情報の変更コマンド（hmpnbnkctl）で，対象金融機関情報格納用テーブルまたは国庫金対象金融機関情報格納用テーブルに登録されます。

各収納機関で扱える金融機関情報数によって，対象金融機関情報格納用テーブルまたは国庫金対象金融機関情報格納用テーブルに登録される件数が決まります。

金融機関情報数（単位：件）：a

金融機関情報のレコード数

金融機関情報のレコード数（レコード）＝a

(2)　1レコード当たりの最大サイズ

各テーブルの1レコード当たりの最大サイズを次に示します。

対象金融機関情報格納用テーブル：50バイト

国庫金対象金融機関情報格納用テーブル：63バイト

ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。

(3)　ユーザー用RDエリアの計算式

（1）および（2）の値を利用して，各テーブルのユーザー用RDエリアを算出します。

次に各テーブルのユーザー用RDエリアの計算式を示します。

対象金融機関情報格納用テーブルの場合

ユーザー用RDエリア（バイト）＝a×50×1.25

国庫金対象金融機関情報格納用テーブルの場合

ユーザー用RDエリア（バイト）＝a×63×1.25

(4)　算出例

対象金融機関情報格納用テーブルのユーザー用RDエリアの算出例を次に示します。

（例）

金融機関情報数が500件あるとする。

この場合のユーザー用RDエリアの計算式を次に示します。

500（件）×50（バイト）×1.25＝31,250（バイト）

付録A.7　収納機関情報を格納するためのユーザー用RDエリアの算出方法

収納機関情報をDBに格納するために，次の対象収納機関情報格納用テーブルの格納領域を用意します。なお，このテーブルは，通信サーバfor Billerに一つだけ必要です。

テーブルの種別 | テーブル名
対象収納機関情報格納用テーブル | HMPNR

なお，対象収納機関情報格納用テーブルだけを格納するユーザー用RDエリアを一つ確保することもできますが，そのほかのユーザー用RDエリアとまとめて確保することもできます。

ユーザー用RDエリアは，次の計算式から算出します。

ユーザー用RDエリア（バイト）＝収納機関情報のレコード数（レコード）×1レコード当たりの最大サイズ（バイト）×1.25

次に，収納機関情報のレコード数，および1レコード当たりの最大サイズの考え方について説明します。

＜この項の構成＞

(1)　収納機関情報のレコード数

(2)　1レコード当たりの最大サイズ

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　収納機関情報のレコード数

収納機関情報は，収納機関情報の変更コマンド（hmpnrcvctl）で，対象収納機関情報格納用テーブルに登録されます。

通信サーバfor Billerで扱う収納機関の数でレコード数が決まります。

収納機関の数：a

収納機関情報のレコード数

収納機関情報のレコード数（レコード）＝a

(2)　1レコード当たりの最大サイズ

対象収納機関情報格納用テーブルの1レコード当たりの最大サイズは，63バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。なお，このテーブルには可変長項目が含まれていますが，全体サイズに大きな影響はありません。

(3)　ユーザー用RDエリアの計算式

（1）および（2）の値を利用して，対象収納機関情報格納用テーブルのユーザー用RDエリアを算出します。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝a×63×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

通信サーバfor Billerで扱う収納機関数が10機関あるとする。

この場合のユーザー用RDエリアの計算式を次に示します。

10（機関）×63（バイト）×1.25＝787.5（バイト）

なお，ユーザー用RDエリアのため，繰り上げて788バイトの領域を確保します。

付録A.8　不正電文情報を格納するためのユーザー用RDエリアの算出方法

不正電文情報をDBに格納するために，次の障害情報格納用テーブルの格納領域を用意します。なお，このテーブルは，通信サーバfor Billerに一つだけ必要です。

テーブルの種別 | テーブル名
障害情報格納用テーブル | HMPNERROR

なお，障害情報格納用テーブルだけを格納するユーザー用RDエリアを一つ確保することもできますが，そのほかのユーザー用RDエリアとまとめて確保することもできます。

ユーザー用RDエリアは次の計算式から算出します。

ユーザー用RDエリア（バイト）＝不正電文情報のレコード数（レコード）×平均電文長（バイト）×1.25

次に，不正電文情報のレコード数，および平均電文長の考え方について説明します。

＜この項の構成＞

(1)　不正電文情報のレコード数

(2)　平均電文長

(3)　ユーザー用RDエリアの計算式

(4)　算出例

(1)　不正電文情報のレコード数

不正電文情報は，次のようなタイミングで取得されます。

図A-6　不正電文情報を取得するタイミング（照会依頼電文の場合）

電文種別に関係なく，1日に送受信される電文のエラー発生の回数によって，不正電文情報のレコード数が決まります。エラーが発生した場合だけ取得するため，ほかのテーブルのようにレコード数は多くありません。

次に，不正電文情報のレコード数の計算式を示します。

電文のエラー発生の件数（単位：件）：a

不正電文情報のレコード数の計算式

不正電文情報のレコード数（レコード）＝a

(2)　平均電文長

障害情報格納用テーブルの1レコード当たりの最大サイズは，5,450バイトです。ユーザー用RDエリアのサイズを算出する場合には，1レコード当たりの最大サイズで見積もる必要があります。ただし，障害情報格納用テーブルの項目には，VARCHAR型の可変長項目であるMPN電文のデータ部が含まれるため，この部分に電文種別ごとの平均値を採用することで，用意するユーザー用RDエリアの見積もり量を抑えることができます。

次に，平均電文長の計算式を示します。なお，取消依頼電文（国庫金の場合，国庫金取消依頼電文），取消応答電文（国庫金の場合，国庫金取消応答電文），再送確認通知電文（国庫金の場合，国庫金再送確認通知電文）および再送確認応答電文（国庫金の場合，国庫金再送確認応答電文）の割合は無視できるほど小さいため，平均電文長の計算式には含めません。

電文種別ごとの平均値（単位：バイト）

照会依頼電文：b

照会応答電文：c

消込依頼電文（国庫金の場合，国庫金消込依頼電文）：d

消込応答電文（国庫金の場合，国庫金消込応答電文）：e

平均電文長の計算式

平均電文長（バイト）＝（b＋c＋d＋e）÷4

(3)　ユーザー用RDエリアの計算式

（1）および（2）で算出した値を利用して，障害情報格納用テーブルのユーザー用RDエリアを算出します。

次にユーザー用RDエリアの計算式を示します。

ユーザー用RDエリア（バイト）＝a×（b＋c＋d＋e）÷4×1.25

(4)　算出例

ユーザー用RDエリアの算出例を次に示します。

（例）

1日当たりに不正電文情報レコードが1回発生すると考える。

電文種別ごとの平均値から算出した平均電文長は，600バイトである。また，各種の不正電文情報は7日間保存できるようにする。

この場合のユーザー用RDエリアの計算式を次に示します。

1（件）×600（バイト）×7（日）×1.25＝5,250（バイト）

付録A.9　状態管理情報を格納するためのユーザー用RDエリアの算出方法

クラスタ構成を利用する場合，開閉局制御の状態管理情報をDBに格納するために，次の状態管理情報格納用テーブルの格納領域を用意します。なお，このテーブルは，通信サーバfor Billerに一つだけ必要です。

テーブルの種別 | テーブル名
状態管理情報格納用テーブル | HMPNSTINFO

なお，状態管理情報格納用テーブルだけを格納するユーザー用RDエリアを一つ確保することもできますが，そのほかのユーザー用RDエリアとまとめて確保することもできます。

状態管理情報格納用テーブルはほかのテーブルと違い，1レコードだけ格納されます。そのため，ユーザー用RDエリアには，状態管理情報格納用テーブルの1レコードに必要なサイズを確保します。状態管理情報格納用テーブルの1レコード当たりの最大サイズは82バイトです。

ユーザー用RDエリアは，次のようになります。

ユーザー用RDエリア（バイト）＝82

付録B　制御ヘッダー部のフォーマット

制御ヘッダー部のフォーマットについて説明します。

制御ヘッダー部はリターンコードと電文ID，お客様番号（納付番号），確認番号，および納付区分から構成されています。リターンコードは，通信サーバfor Billerと収納業務プログラムとの間での，障害の有無を通知します。電文IDは，送受信する電文を識別する通番として使用します。なお，電文ID，お客様番号（納付番号），確認番号，および納付区分は通信サーバfor Billerが設定し，リターンコードは収納業務プログラムが設定します。

制御ヘッダー部のフォーマットを次に示します。

表B-1　制御ヘッダー部のフォーマット

項目名 | 内容 | 属性 | サイズ（単位：バイト）
リターンコード | 収納業務プログラムからのリターンコード（初期値はALL0）※1 | char | 8
電文ID※2 | 自センタコード | 自センタコード | char | 10
通番 | プロセスごとの通番（0～99999999） | char | 8
日時 | 処理日時 | char | 14
プロセスID | 処理した電文受信CUPのプロセスID（16進数） | char | 8
ユーザサーバ名 | 処理する業務系SPPのユーザサーバ名 | char | 8
お客様番号（納付番号） | 受信した電文のお客様番号（納付番号）※3 | char | 20
確認番号 | 受信した電文の確認番号※4 | char | 6
納付区分 | 受信した電文の納付区分※5 | char | 16
合計 | 98

注※1

収納業務プログラムでは，「HMPN」で始まるリターンコードを使用できません。

注※2

電文IDはプロセス単位に設定されるため，通番がラップアラウンドした場合，およびプロセスが再起動したときに使用されていたプロセスIDが振り当てられた場合には，同一の電文IDが設定されることがあります。

注※3

照会依頼電文，取消依頼電文（国庫金の場合，国庫金取消依頼電文），消込依頼電文（国庫金の場合，国庫金消込依頼電文），および再送確認通知電文（国庫金の場合，国庫金再送確認通知電文）の場合で，入力区分がOCR，バーコード情報のとき，ユーザーコールバックのデータ解析で取得したお客様番号（納付番号）が設定されます。

注※4

照会依頼電文および照会応答電文の場合で，入力区分がOCRまたはバーコード情報のとき，ユーザーコールバックのデータ解析で取得した確認番号が設定されます。

消込依頼電文（国庫金の場合，国庫金消込依頼電文），および再送確認通知電文（国庫金の場合，国庫金再送確認通知電文）の場合は，お客様番号（納付番号），請求番号（識別番号），および納付区分から特定した確認番号が設定されます。

なお，確認番号を特定できない場合は，次の項目または値が設定されます。

・入力区分が情報リンク方式の場合：依頼電文中の確認番号（bit6）

・入力区分が情報リンク方式以外の場合：NULL

注※5

一般料金の場合，および国庫金で収納機関コードが国税庁（00200000）以外の場合は，納付区分にはNULLが設定されます。

付録C　消込処理でのエラー内容

消込処理で発生するおそれがある現象，障害後の通信サーバfor Billerの処理，DBの更新有無，およびDBからのリターン情報を次に示します。

＜この節の構成＞

(1)　オンライン消込でのエラー内容（地方税・地公体料金，一般料金の場合）

(2)　オンライン消込でのエラー内容（国庫金の場合）

(3)　オフライン消込でのエラー内容

(1)　オンライン消込でのエラー内容（地方税・地公体料金，一般料金の場合）

地方税・地公体料金，一般料金のオンライン消込処理で発生するおそれがある現象，障害後の通信サーバfor Billerの処理，DBの更新有無，およびDBのリターン情報を次に示します。

表C-1　消込処理で発生するおそれがある現象とDBのリターン情報（オンライン消込：地方税・地公体料金，一般料金の場合）

現象
障害発生後の処理
DBの更新
DBのリターン情報

複数件消込
消込正常応答
○
HMPN9001

お客様番号（納付番号）エラー（OCR情報，またはバーコード情報が不正）
消込正常応答
○
HMPNA003

確認番号エラー（OCR情報，またはバーコード情報が不正）
消込正常応答
○
HMPNA004

対象金融機関エラー
＜収納金融機関エラーの場合＞
消込正常応答
○
HMPNA002

＜当該請求取扱不可の場合＞
消込正常応答
○
HMPNA010

＜納付区分エラーの場合＞
消込正常応答
○
HMPNA013

納付情報，または請求情報の取得に失敗（入力区分が情報リンク以外の場合）
消込正常応答
○
HMPNA101

（凡例）

○：DBを更新する

(2)　オンライン消込でのエラー内容（国庫金の場合）

国庫金のオンライン消込処理で発生するおそれがある現象，障害後の通信サーバfor Billerの処理，および収納業務プログラムへ渡すリターン情報を次に示します。

表C-2　消込処理で発生するおそれがある現象と収納業務プログラムへ渡すリターン情報（オンライン消込：国庫金の場合）

現象
障害発生後の処理
収納業務プログラムへ渡すリターン情報

納付番号エラー（OCR情報，またはバーコード情報が不正）
収納業務プログラムの呼び出し
HMPNA003

確認番号エラー（OCR情報，またはバーコード情報が不正）
収納業務プログラムの呼び出し
HMPNA004

収納委託金融機関チェックエラー
＜収納金融機関エラーの場合＞
収納業務プログラムの呼び出し
HMPNA002

＜チャネルエラーの場合＞
収納業務プログラムの呼び出し
HMPNA010

＜納付区分エラーの場合＞
収納業務プログラムの呼び出し
HMPNA013

(3)　オフライン消込でのエラー内容

オフライン消込処理で発生するおそれがある現象，障害後の通信サーバfor Billerの処理，DBの更新有無，およびDBのリターン情報を次に示します。

表C-3　消込処理で発生するおそれがある現象とDBのリターン情報（オフライン消込の場合）

現象
障害発生後の処理
DBの更新
DBのリターン情報

対象金融機関エラー※
＜収納金融機関エラーの場合＞
消込情報のリターン情報に"HMPNA002"を設定する。
×
－

＜当該請求取扱不可の場合＞
消込情報のリターン情報に"HMPNA010"を設定する。
×
－

＜納付区分エラーの場合＞
消込情報のリターン情報に"HMPNA013"を設定する。
×
－

支払い情報なし（納付情報，または請求情報が存在しない）
処理継続（次レコードの消込処理を行う）
○
HMPNA303

（凡例）

○：DBを更新する

×：DBを更新しない

－：該当しない

注※

収納委託契約のある金融機関かどうかの判断は，ファイル転送で送られてくる伝送ファイルを消込情報ファイルに変換するときに行います。

付録D　DB Utility for Biller

HiRDBを通信サーバfor Billerと別のマシンにセットアップした場合，DBバッチ処理機能は使用できません。DB Utility for Billerは，別のマシンにセットアップしたDBで，DBバッチ処理機能を使用するためのユティリティです。

ここでは，DB Utility for Billerについて説明します。

＜この節の構成＞

付録D.1　DB Utility for Billerの概要

付録D.2　DB Utility for Billerのインストールと環境設定

付録D.3　システム定義（DB Utility for Biller）

付録D.4　DBへのテーブルの作成（DB Utility for Biller）

付録D.5　ユーザーコールバックインターフェース（DB Utility for Biller）

付録D.6　システム運用（DB Utility for Biller）

付録D.7　コマンドリファレンス（DB Utility for Biller）

付録D.1　DB Utility for Billerの概要

DB Utility for Billerの機能，ソフトウェア構成などについて説明します。

＜この項の構成＞

(1)　DB Utility for Billerの機能

(2)　前提条件

(1)　DB Utility for Billerの機能

DB Utility for Billerは，通信サーバfor Billerの次に示すDBバッチ処理機能を提供します。

納付情報の一括登録

請求情報の一括登録

消込情報ファイルの変換

一括消込

消込情報の出力

金融機関情報の変更

収納機関情報の変更

各DBバッチ処理機能については，「8.4　DBバッチ処理の運用」を参照してください。

(2)　前提条件

DB Utility for Billerの前提OSおよび前提ソフトウェアについて説明します。

前提OS

AIX 5Lの場合

AIX 5L Version 5.1，AIX 5L Version 5.2，またはAIX 5L Version 5.3

HP-UXの場合

HP-UX 11.0，またはHP-UX 11i

前提ソフトウェア

HiRDB/Single Server，またはHiRDB/Parallel Server

ソフトウェア構成

DB Utility for Billerのソフトウェア構成を次に示します。

図D-1　ソフトウェア構成（DB Utility for Biller）

付録D.2　DB Utility for Billerのインストールと環境設定

DB Utility for Billerのインストール，および環境設定の方法について説明します。

また，DB Utility for Billerのインストール前に，HiRDBのインストール，および環境設定を必ずしてください。

＜この項の構成＞

(1)　インストール/環境設定する前に

(2)　インストール

(3)　DB Utility for Billerの環境設定

(1)　インストール/環境設定する前に

DB Utility for Billerのインストールおよび環境設定をする前に，注意する点を説明します。

インストールされているソフトウェアによって，DB Utility for Billerをインストールできる場合と，できない場合があります。インストールされているソフトウェアとDB Utility for Billerのインストール状態について次に示します。

表D-1　DB Utility for Billerのインストール状態

インストールされている
ソフトウェア
DB Utility for Billerのインストール

通信サーバBase
×

通信サーバfor Biller
×

DB Utility for Biller
○

（凡例）

○：インストールできるが，アンインストールしてからインストールすることを推奨する。

×：インストールできない。必ずアンインストールしてから，インストールすること。

インストールに失敗した場合は，必ずアンインストールしてからインストールしてください。また，アンインストールする際，ユーザーが任意で作成したファイルは削除されません。ファイルの削除および移動は，ユーザー自身で行ってください。

(2)　インストール

DB Utility for Billerをインストールするには，日立PPインストーラを実行してください。アンインストールする場合も同様です。

(3)　DB Utility for Billerの環境設定

DB Utility for Billerの環境設定は，次の手順で行ってください。

セットアップディレクトリを作成する
次の形式で，DB Utility for Billerのセットアップディレクトリを作成してください。この操作はスーパーユーザーで行ってください。

# mkdir セットアップディレクトリ

なお，「/usr」，「/usr/bin」，「/」などOSが使用するディレクトリでセットアップすると，OSに不具合が生じる場合があります。これらのディレクトリにはセットアップしないでください。

セットアップコマンド（hmpnsetup）を実行する※
次の形式で，セットアップコマンドを実行してください。

# /opt/hitachi/HMPN/bin/hmpnsetup -s （DB Utility for Billerセットアップディレクトリ）

なお，DB Utility for Billerをアンセットアップする場合は，セットアップコマンドに「-d」オプションを付けて実行してください。
セットアップコマンドの詳細については，「付録D.7(3)(h)　hmpnsetup（セットアップ）」を参照してください。

注※

環境変数LANG，およびTZを必ず設定した環境で，セットアップコマンドを実行してください。

環境変数を設定する
DB Utility for Biller管理者の環境で，次の環境変数を設定してください。なお，DB Utility for Biller管理者は，HiRDBの権限が必要です。必要なHiRDBの権限については，「3.3　前提ソフトウェアの環境設定」を参照してください。

表D-2　DB Utility for Biller管理者の環境に設定する環境変数

環境変数名
設定内容

HMPNDIR
DB Utility for Billerのセットアップディレクトリを指定します。

PATH
DB Utility for Billerが提供するコマンドが動作するために必要なパスを指定します。
（HiRDBセットアップディレクトリ）/bin:（DB Utility for Billerセットアップディレクトリ）/bin

LIBPATH（AIX 5Lの場合）
SHLIB_PATH（HP-UXの場合）
共用ライブラリのサーチパスを指定します。
/lib:/usr/lib:/opt/hitachi/common/lib:（HiRDBセットアップディレクトリ）/lib:（DB Utility for Billerセットアップディレクトリ）/usrlib:（DB Utility for Billerセットアップディレクトリ）/lib

NLSPATH
メッセージカタログへのパスを指定します。
/usr/lib/nls/msg/%L/%N:/usr/lib/nls/%l/%t/%c/%N:（DB Utility for Billerセットアップディレクトリ）/lib/msg/%L/%N

LANG
言語環境を指定します。

AIX 5Lの場合
CまたはJa_JP

HP-UXの場合
Cまたはja_JP.SJIS

PDHOST
通信サーバfor Billerで使用するDBがHiRDBの場合に，HiRDBのホスト名を指定します。HiRDB/Single Serverの場合はHiRDB/Single Serverのあるホスト名を，HiRDB/Parallel Serverの場合はシステムマネジャのあるホスト名を指定します。また，通信サーバシステム定義の「BL_ENV」に指定した「PDHOST」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDDIR
HiRDBのセットアップディレクトリを絶対パスで指定します。

PDUSER
HiRDBにアクセスするユーザー名，およびパスワードを指定します。指定するユーザー名は通信サーバ管理者にしてください。通信サーバシステム定義の「BL_ENV」に指定した「PDUSER」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDNAMEPORT
HiRDBサーバのポート番号を指定します。通信サーバシステム定義の「BL_ENV」に指定した「PDNAMEPORT」と同じ値を指定してください。「BL_ENV」については，「4.4.4(5)　通信サーバfor Biller共通定義」を参照してください。

PDCONFPATH
HiRDBのシステム定義ファイルを格納するディレクトリを絶対パスで指定します。

付録D.3　システム定義（DB Utility for Biller）

DB Utility for Billerは，必ず通信サーバfor Billerと同じ通信サーバシステム定義のファイルを使用します。通信サーバfor Billerからファイルを取得し，使用してください。

通信サーバfor Billerの定義ファイルは，次の手順で取得してください。

通信サーバfor Billerがセットアップされているマシンから，通信サーバシステム定義ファイルを取得する
ftpなどを使用して，取得してください。

取得した定義ファイル（HMpnSvConf）を所定のディレクトリに格納する
定義ファイルは，次のディレクトリに格納してください。
（DB Utility for Billerセットアップディレクトリ）/conf

注意

通信サーバfor Billerの定義ファイルに変更があった場合は，再度定義ファイルを取得してください。

付録D.4　DBへのテーブルの作成（DB Utility for Biller）

DBバッチ処理に必要なテーブル，および通信サーバfor Billerがオンラインで使用するテーブルを作成します。DB Utility for Billerで作成が必要なテーブル，およびサンプルSQLファイルが格納されているディレクトリを次に示します。

表D-3　DB Utility for Billerに必要なテーブル一覧

テーブルの種類
格納ディレクトリ

電文履歴格納用テーブル

地方税・地公体料金用

（DB Utility for Billerセットアップディレクトリ）/examples/sql/public/

一般料金用

（DB Utility for Billerセットアップディレクトリ）/examples/sql/general/

国庫金用

（DB Utility for Billerセットアップディレクトリ）/examples/sql/treasury/

消込情報格納用テーブル

地方税・地公体料金用

（DB Utility for Billerセットアップディレクトリ）/examples/sql/public/

一般料金用

（DB Utility for Billerセットアップディレクトリ）/examples/sql/general/

対象金融機関情報格納用テーブル

納付情報格納用テーブル
（DB Utility for Billerセットアップディレクトリ）/examples/sql/public/

請求情報格納用テーブル
（DB Utility for Billerセットアップディレクトリ）/examples/sql/general/

収納カウンタ情報格納用テーブル
（DB Utility for Billerセットアップディレクトリ）/examples/sql/

対象収納機関情報格納用テーブル

障害情報格納用テーブル

状態管理情報格納用テーブル

国庫金消込情報格納用テーブル
（DB Utility for Billerセットアップディレクトリ）/examples/sql/treasury/

国庫金対象金融機関情報格納用テーブル

国庫金納付情報格納用テーブル

各テーブルの作成方法については，「5　DBへのテーブルの作成」を参照してください。

付録D.5　ユーザーコールバックインターフェース（DB Utility for Biller）

データ解析機能のユーザーコールバックを提供しています。また，サンプルファイルを直接使用する場合，ユーザーコールバックの作成は不要です。

サンプルファイルが格納されているディレクトリを次に示します。

表D-4　ユーザーコールバックのサンプルファイル（DB Utility for Biller）

ファイル名
種別
格納ディレクトリ

HMpnUoc.c
サンプルファイル

地方税・地公体料金用

（DB Utility for Billerセットアップディレクトリ）/examples/uoc/public/

一般料金用

（DB Utility for Billerセットアップディレクトリ）/examples/uoc/general/

HMpnUoc.h
ヘッダーファイル

Makefile
メイクファイル

ユーザーコールバックの役割，作成手順などについては，「6　ユーザーコールバックの作成」を参照してください。

付録D.6　システム運用（DB Utility for Biller）

DB Utility for Billerはコマンドで運用します。DB Utility for Billerで使用するコマンドについては「付録D.7　コマンドリファレンス（DB Utility for Biller）」を参照してください。

また，障害情報は，DBバッチ処理機能の各コマンドで出力される結果報告ファイルなどで取得します。DBバッチ処理機能の各コマンドで出力される結果報告ファイルについては「8.4　DBバッチ処理の運用」，または「10.3　コマンドの詳細」を参照してください。

付録D.7　コマンドリファレンス（DB Utility for Biller）

DB Utility for Billerを運用する上で必要なコマンドについて説明します。

＜この項の構成＞

(1)　コマンドの概要

(2)　コマンド一覧

(3)　コマンドの詳細

(1)　コマンドの概要

コマンドを実行できるユーザー，およびコマンド実行時の注意事項について説明します。

(a)　コマンドを実行できるユーザー

コマンドの実行に必要な権限は，コマンドの種類によって異なります。

セットアップコマンド（hmpnsetup）の場合

セットアップコマンドを実行するユーザーは，スーパーユーザーである必要があります。なお，スーパーユーザーの環境には，環境変数LANG，およびTZを必ず設定してください。

上記以外のコマンド（DBバッチ処理機能のコマンド）の場合

上記以外のコマンドを実行するユーザーは，次の条件をすべて満たしている必要があります。

DB Utility for Biller管理者である

通信サーバ管理者である

(b)　注意事項

コマンド実行時は，次の点に注意してください。

環境変数について

コマンドを実行するには，DB Utility for Billerの環境変数が設定されている必要があります。環境変数については，「付録D.2(3)　DB Utility for Billerの環境設定」を参照してください。

オプションの指定について

コマンドのオプションの値として，ワイルドカードは使用できません。

メッセージの出力について

メッセージの可変部分をDB Utility for Billerが特定できない場合は，メッセージの可変部分に「*」が出力されます。

(2)　コマンド一覧

DB Utility for Billerで実行するコマンドを次に示します。セットアップコマンド以外は，すべて通信サーバfor BillerのDBバッチ処理機能のコマンドと同じ機能です。

表D-5　コマンド一覧（DB Utility for Biller）

コマンド | 機能 | 各収納サービスでのコマンドの実行可否
地方税・地公体料金 | 一般料金 | 国庫金
hmpnbilload | 納付情報の一括登録 | ○ | ○ | ×
hmpndemload | 請求情報の一括登録 | ○ | ○ | ×
hmpnpayfile | 消込情報ファイルの変換 | ○ | ○ | ×
hmpnpayload | 一括消込 | ○ | ○ | ×
hmpnpaylist | 消込情報の出力 | ○ | ○ | ○
hmpnbnkctl | 金融機関情報の変更 | ○ | ○ | ○
hmpnrcvctl | 収納機関情報の変更 | ○ | ○ | ×
hmpnsetup | セットアップ | ○ | ○ | ○

（凡例）

○：実行できる

×：実行できない

注1

DBバッチ処理機能のコマンドは，通信サーバfor Billerの停止中での実行を推奨します。なお，通信サーバfor Billerの起動中にも実行できますが，同じテーブルに対してアクセスした場合に排他待ち状態となり，オンライン処理が停止するおそれがあります。

注2

同じ収納機関コードで，次に示す一方のコマンドを実行しているときは，もう一方のコマンドを実行できません。

・納付情報の一括登録コマンド（hmpnbilload）および一括消込コマンド（hmpnpayload）

・請求情報の一括登録コマンド（hmpndemload）および一括消込コマンド

(3)　コマンドの詳細

DB Utility for Billerで実行できる各コマンドについて説明します。

(a)　hmpnbilload（納付情報の一括登録）

納付情報の一括登録コマンド（hmpnbilload）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpnbilload（納付情報の一括登録）」を参照してください。

(b)　hmpndemload（請求情報の一括登録）

請求情報の一括登録コマンド（hmpndemload）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpndemload（請求情報の一括登録）」を参照してください。

(c)　hmpnpayfile（消込情報ファイルの変換）

消込情報ファイルの変換コマンド（hmpnpayfile）の記述形式，機能については，「10.3　コマンドの詳細　hmpnpayfile（消込情報ファイルの変換）」を参照してください。

(d)　hmpnpayload（一括消込）

一括消込コマンド（hmpnpayload）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpnpayload（一括消込）」を参照してください。

(e)　hmpnpaylist（消込情報の出力）

消込情報の出力コマンド（hmpnpaylist）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpnpaylist（消込情報の出力）」を参照してください。

(f)　hmpnbnkctl（金融機関情報の変更）

金融機関情報の変更コマンド（hmpnbnkctl）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpnbnkctl（金融機関情報の変更）」を参照してください。

(g)　hmpnrcvctl（収納機関情報の変更）

収納機関情報の変更コマンド（hmpnrcvctl）の記述形式，機能などについては，「10.3　コマンドの詳細　hmpnrcvctl（収納機関情報の変更）」を参照してください。

(h)　hmpnsetup（セットアップ）

形式

hmpnsetup {-s セットアップディレクトリ |-d -s セットアップディレクトリ}

機能

DB Utility for Billerをセットアップ，またはアンセットアップします。

注意

セットアップコマンドを実行する前に次に示す事項について確認してください。

DB Utility for Billerをインストール済みかどうか

DB Utility for Billerが稼働していないかどうか

DB Utility for Billerのセットアップディレクトリがあるかどうか，またセットアップ先ディレクトリのユーザー，およびグループをDB Utility for Biller管理者に変更してあるかどうか

なお，セットアップコマンドはスーパーユーザーで実行してください。

オプション

-s セットアップディレクトリ

DB Utility for Billerをセットアップするディレクトリを指定してください。

-d

アンセットアップする場合に指定してください。

戻り値

0：正常終了

0以外：エラーリターン

付録E　用語解説

（英字）

CUP（Client User Program）

OpenTP1のUAPのうち，WSまたはPCからTP1/Clientのライブラリ関数を使ってSPPのサービスを要求する，クライアント専用のプログラムです。CUPは，OpenTP1クライアント機能が前提となります。

SPP（Service Providing Program）

OpenTP1のUAPのうち，ファイルへのアクセスなど，サーバの役割をするプログラムです。SPPは，クライアントUAPから要求されたサービスを実行するサービス関数と，サービス関数をまとめるメイン関数から構成されます。

UAP（User Application Program）

ユーザーの業務をプログラムとして作成したものです。アプリケーションプログラムともいいます。

（ア行）

一般収納サービス

民間企業を収納機関の対象とした収納サービスです。

（カ行）

開局

オンライン処理を開始する操作です。開局には，自動開局とコマンドによる手動開局があります。

基幹システム

基幹業務を遂行するために使用するシステムです。金融機関の基幹システムは，利用者の口座を管理したり，支払いチャネルを制御したりするのに使用されます。収納機関の基幹システムは，顧客情報を作成したり，管理したりするのに使用されます。

共通ソフトウェア

通信サーバが，伝送制御手順を意識することなく，MPNセンタと通信するためのソフトウェアです。金融機関および収納機関は，共通ソフトウェアを経由してMPNセンタと接続します。

系

CPU単位で，サーバが稼働するシステムの単位を示します。システムを構成するハードウェアや，システム上で稼働するプログラムを総称して「系」といいます。

系切り替え

業務処理を実行中のシステム（系）を，待機しているシステム（系）と置き換える機能です。

消込サービス

利用者が料金，税金などを支払ったときに，その請求情報の消込依頼を収納機関に通知し，消込結果を利用者に返信するサービスです。

現用系

起動時に，最初に業務処理を実行するシステム（系）です。

国庫金収納サービス

官公庁を収納機関の対象とした収納サービスです。

（サ行）

再送確認サービス

金融機関またはMPNセンタで消込処理がタイムアウトした場合に，収納機関に消込依頼の再送確認を通知し，消込処理を完了するサービスです。

支払いチャネル

金融機関が利用者に向けて，各業務メニューを提供するシステムです。支払いチャネルには，ATM，PC，電話，窓口などがあります。

収納カウンタ情報

通信サーバfor BillerとMPNセンタ間の収納情報の集計値が含まれた情報で，オンライン取引の精査に利用できます。

収納機関サービス

収納機関ごとの収納サービスです。通信サーバfor Billerでは，通信サーバシステム定義によって，指定した収納機関の収納サービスを起動または停止することができます。

収納業務プログラム

通信サーバfor Billerと連携して使用する汎用業務プログラムです。MPNのサービスを実現するために，収納機関の業務機能および運用機能を提供します。

収納サーバ

収納機関の基幹システムの一部として，財務系システムと連携して収納業務処理をするサーバです。

収納サービス

金融機関が提供する各種支払いチャネルを使用して，収納機関から請求された料金を支払えるようにするサービスです。また，その消込情報は，MPNを通じて，即時に収納機関に通知されます。

照会サービス

利用者から請求情報の照会依頼があったときに，収納機関に請求情報を照会し，請求情報を利用者に返信するサービスです。

状態表示

通信サーバfor Billerの構成の種類，起動状態，開閉局状態および各収納機関の収納機関サービスの状態を表示する操作です。

スーパーユーザー

UNIXの最高権限を持つユーザーです。UNIXファイルシステムのすべてのファイルに対してアクセス権を持ちます。スーパーユーザーの利用者名はrootで固定されています。

（タ行）

地公体収納サービス

地方公共団体を収納機関の対象とした収納サービスです。

取消サービス

消込済みの請求情報を消込前の状態（料金を支払う前の状態）に戻すサービスです。

（ハ行）

閉局

オンライン処理を終了する操作です。

（ヤ行）

ユーザーコールバック

ユーザー固有の処理をするために，ユーザーが処理をコーディングする部分です。

予備系

起動時に，最初に稼働状態で待機するシステム（系）です。

予備閉局

収納情報の照会サービスを受け付けず，消込サービスおよび取消サービスを受け付ける状態にすることです。

索引

[記号]
[Ａ][Ｂ][Ｃ][Ｄ][Ｅ][Ｈ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(記号)

/etc/hostsファイルおよび/etc/servicesファイルの記述例〔通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合〕

/etc/hostsファイルおよび/etc/servicesファイルの記述例〔通信サーバfor Biller単独でのHA構成の場合〕

[COMMON]

[HMPN/BL/CUP]

[HMPN/BL/MON/USERSV]

[HMPN/BL/MON]

[HMPN/BL/SRV/（収納機関コード）/CAN]

[HMPN/BL/SRV/（収納機関コード）/COM]

[HMPN/BL/SRV/（収納機関コード）/PAY]

[HMPN/BL/SRV/（収納機関コード）/REF]

[HMPN/BL/SRV/（収納機関コード）/RESEND]

[HMPN/BL/SRV/（収納機関コード）]

[HMPN/BL]

[HMPN/CODE]

[HMPN/DB]

[HMPN/HA]

(英字)

(Ａ)

AUTO_OPEN

AUTO_START

(Ｂ)

betranrc

BL_AUTO_START

BL_ENV

BUSCUP_TERM_WATCH_TIME

BUSCUP_WATCH_COUNT

BUSCUP_WATCH_TIMER

(Ｃ)

CAN_SERVICE

CAN_SERVICEGRP

CAN_USERSV

CENTER_CODE

CHANNEL_NAME

CLUSTER_MODE

CONNECT_RETRY_INTERVAL

CONNECT_RETRY_TIMES

COUNT_SERVICE

COUNT_SERVICEGRP

COUNT_USERSV

COUNT_WAIT_TIME

CTLCUP_TERM_WATCH_TIME

CTLCUP_WATCH_COUNT

CTLCUP_WATCH_TIMER

CUP_COUNT

CUP〔用語解説〕

(Ｄ)

DB Option for Biller〔通信サーバの種類〕

DB Utility for Biller

DB Utility for Biller〔通信サーバの種類〕

DB Utility for Billerのインストールと環境設定

DB Utility for Billerの概要

DB Utility for Billerの環境設定

DB Utility for Billerの機能

DB定義

DBに作成するテーブルの種類

DBのテーブルに出力される障害情報

DBバッチ処理の運用

DBバッチ処理の運用手順

DBへのテーブルの作成

DBへのテーブルの作成（DB Utility for Biller）

DCCONFPATH

DCDIR

DCHOST

(Ｅ)

env

(Ｈ)

HA_KIND

HA構成に必要な定義

HA構成の形態

HA構成の場合〔システム構成例〕

HA構成の場合〔障害と対処〕

HA構成の場合の起動と停止

HA定義

HAモニタ〔環境設定〕

HAモニタの環境設定（sysdef）

HAモニタの定義

HAモニタの定義項目

HAモニタの定義の記述例〔通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合〕

HAモニタの定義の記述例〔通信サーバfor Biller単独でのHA構成の場合〕

HAモニタの定義の手順

HiRDB/Parallel ServerでのDBバッチ処理の運用手順

HiRDB/Single ServerでのDBバッチ処理の運用手順

HiRDB（通信サーバfor Billerと同一マシン上にセットアップする場合）〔HA構成の場合の障害と対処〕

HiRDB（通信サーバfor Billerと別のマシンにセットアップする場合）〔HA構成の場合の障害と対処〕

HiRDB〔環境設定〕

HiRDB〔クラスタ構成の場合の障害と対処〕

HiRDB〔プロセスの概要〕

HiRDBのRDエリアの見積もり方法

HiRDBの障害情報

HiRDBの定義

HiRDBの定義項目

HiRDBの定義の記述例〔通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合〕

HiRDBの定義の記述例〔通信サーバfor Biller単独でのHA構成の場合〕

HiRDBの定義の手順

hmpnbilload

hmpnbilload〔DB Utility for Biller〕

hmpnblinit

hmpnbnkctl

hmpnbnkctl〔DB Utility for Biller〕

HMpnCan

hmpnclose

HMpnCnt

hmpncntget

hmpndemload

hmpndemload〔DB Utility for Biller〕

HMPNDIR

HMPNDIR〔DB Utility for Biller〕

hmpnopen

HMpnPay

hmpnpayfile

hmpnpayfile〔DB Utility for Biller〕

hmpnpaylist

hmpnpaylist〔DB Utility for Biller〕

hmpnpayload

hmpnpayload〔DB Utility for Biller〕

hmpnrcvctl

hmpnrcvctl〔DB Utility for Biller〕

HMpnRdb

HMpnRef

HMpnRes

hmpnsetup

hmpnsetup〔DB Utility for Biller〕

hmpnstart

hmpnstat

hmpnstop

hmpnsvclose

hmpnsvopen

HMpnTCan

HMpnTPay

HMpnTRef

HMpnTRes

HOST_NAME

(Ｌ)

LANG

LANG〔DB Utility for Biller〕

LANの状態設定ファイルの作成

LIBPATH

LIBPATH〔DB Utility for Biller〕

log

(Ｍ)

MPN_BL_SOFT_ENV_FILE

MPN_BL_SOFT_MQ_STP_SH

MPN_BL_SOFT_MQ_STT_SH

MPN_NAME

MPNが提供するサービス

MPNセンタ

MPN電文

MPNとの接続形態

MPNとは

MPNを構成する要素

MPNを利用した支払い方法

(Ｎ)

NAME_PORT

NLSPATH

NLSPATH〔DB Utility for Biller〕

(Ｏ)

OPEN_RETRY_INTERVAL

OPEN_RETRY_TIMES

OPENTP1_WATCH_COUNT

OPENTP1_WATCH_TIMER

OpenTP1〔HA構成の場合の障害と対処〕

OpenTP1〔環境設定〕

OpenTP1〔クラスタ構成の場合の障害と対処〕

OpenTP1〔プロセスの概要〕

OpenTP1監視プロセス〔監視概要〕

OpenTP1監視プロセス〔プロセスの概要〕

OpenTP1の障害情報

OpenTP1の定義

OpenTP1の定義項目

OpenTP1の定義の概要

OpenTP1の定義の記述例〔クラスタ構成の場合〕

OpenTP1の定義の記述例〔通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合〕

OpenTP1の定義の記述例〔通信サーバfor Biller単独でのHA構成の場合〕

OpenTP1の定義の手順

OWN_NAME

(Ｐ)

PATH

PATH〔DB Utility for Biller〕

PAY_SERVICE

PAY_SERVICEGRP

PAY_TYPE

PAY_USERSV

PDCONFPATH

PDCONFPATH〔DB Utility for Biller〕

PDDIR

PDDIR〔DB Utility for Biller〕

PDHOST

PDHOST〔DB Utility for Biller〕

PDNAMEPORT

PDNAMEPORT〔DB Utility for Biller〕

pdsys

PDUSER

PDUSER〔DB Utility for Biller〕

pdutsys

prc

(Ｒ)

RAW_BL_STAT

RAW_WORKPRC_STAT

RDB_USERSV

RDBMS

REF_SERVICE

REF_SERVICEGRP

REF_USERSV

RESEND_SERVICE

RESEND_SERVICEGRP

RESEND_USERSV

RPC_KIND

RPC通信形式〔消込SPP用インターフェース〕

RPC通信形式〔消込SPP用インターフェース〕

RPC通信形式〔再送確認SPP用インターフェース〕

RPC通信形式〔再送確認SPP用インターフェース〕

RPC通信形式〔照会SPP用インターフェース〕

RPC通信形式〔取消SPP用インターフェース〕

(Ｓ)

SHLIB_PATH

SHLIB_PATH〔DB Utility for Biller〕

SPP〔用語解説〕

SPP障害監視プロセス〔監視概要〕

SPP障害監視プロセス〔プロセスの概要〕

SRV_ENV

SV_GRP

sysconf

(Ｔ)

TARGET_HOST

TRC_FILE_NUM

TRC_FILE_SIZE

TRC_LEVEL

TRC_PRC_LEVEL

TRC_SHM_LEVEL

(Ｕ)

UAP〔用語解説〕

USERSV1

USERSV2

USERSVn

usrrc

(Ｖ)

V_BRANCH_CODE（通信サーバfor Biller共通定義）

V_BRANCH_CODE（通信サーバfor Biller業務系SPP定義）

(ア行)

(い)

一括消込

一括消込〔DB Utility for Billerのコマンド〕

一括消込〔機能概要〕

一括消込〔コマンド〕

一般収納サービス

一般収納サービス〔用語解説〕

インストール/環境設定する前に

インストール/環境設定する前に〔DB Utility for Biller〕

インストール〔DB Utility for Biller〕

(う)

上書きセットアップについて

(え)

エラー検出時収納業務プログラム呼び出し機能

エントリポイント

(お)

オプションの指定について

オフライン消込でのエラー内容

オフライン中の運用〔機能概要〕

オンライン消込でのエラー内容（国庫金の場合）

オンライン消込でのエラー内容（地方税・地公体料金，一般料金の場合）

オンライン中の運用〔機能概要〕

(カ行)

(か)

開局〔コマンド〕

開局〔用語解説〕

各プロセスの障害と対処

環境変数について

環境変数の設定内容

監視対象のプロセス

監視プロセス〔HA構成の場合の障害と対処〕

監視プロセス〔クラスタ構成の場合の障害と対処〕

(き)

基幹システム

基幹システム〔用語解説〕

キューマネージャー（オンライン電文用）

キューマネージャー（ファイル転送用）

共通ソフトウェア〔HA構成の場合の障害と対処〕

共通ソフトウェア〔環境設定〕

共通ソフトウェア〔クラスタ構成の場合の障害と対処〕

共通ソフトウェア〔プロセスの概要〕

共通ソフトウェア〔用語解説〕

共通ソフトウェア情報

共通ソフトウェアのチャネルの障害

共通定義

業務系SPP〔HA構成の場合の障害と対処〕

業務系SPP〔クラスタ構成の場合の障害と対処〕

業務系SPP状態ファイル用ロウ論理ボリューム

業務系SPPの格納

業務系プロセスインターフェース

業務系プロセスインターフェースの種類

業務電文〔電文の構成〕

業務電文〔電文の流れ〕

業務電文受信CUP〔HA構成の場合の障害と対処〕

業務電文受信CUP〔クラスタ構成の場合の障害と対処〕

業務電文受信CUP〔プロセスの概要〕

業務電文受信CUP監視プロセス〔監視概要〕

業務電文受信CUP監視プロセス〔プロセスの概要〕

業務電文の構成要素

金融機関情報の変更

金融機関情報の変更〔DB Utility for Billerのコマンド〕

金融機関情報の変更〔機能概要〕

金融機関情報の変更〔コマンド〕

金融機関情報を格納するためのユーザー用RDエリアの算出方法

(く)

クラスタ構成の形態

クラスタ構成の定義の特長

クラスタ構成の場合〔システム構成例〕

クラスタ構成の場合〔障害と対処〕

クラスタ構成の場合の起動と停止

(け)

系〔用語解説〕

系切り替え〔用語解説〕

消込SPP〔プロセスの概要〕

消込SPPの機能

消込SPPの機能

消込SPP用インターフェース（国庫金の場合）

消込SPP用インターフェース（地方税・地公体料金，一般料金の場合）

消込SPP用ユーザサービス定義（HMpnPay）

消込SPP用ユーザサービス定義（HMpnTPay）

消込サービス〔用語解説〕

消込収納業務プログラムデフォルト定義

消込情報格納用テーブル

消込情報格納用テーブルの作成

消込情報の出力

消込情報の出力〔DB Utility for Billerのコマンド〕

消込情報の出力〔機能概要〕

消込情報の出力〔コマンド〕

消込情報の照会用インターフェース

消込情報の照会要求電文の流れ

消込情報ファイルの変換

消込情報ファイルの変換〔DB Utility for Billerのコマンド〕

消込情報ファイルの変換〔機能概要〕

消込情報ファイルの変換〔コマンド〕

消込情報を格納するためのユーザー用RDエリアの算出方法

消込処理でのエラー内容

現用系〔用語解説〕

(こ)

口座振替受付サービス

口座振替データ伝送サービス

国庫金消込情報格納用テーブル

国庫金消込情報格納用テーブルの作成

国庫金収納サービス

国庫金収納サービス〔用語解説〕

国庫金対象金融機関情報格納用テーブル

国庫金対象金融機関情報格納用テーブルの作成

国庫金納付情報格納用テーブル

国庫金納付情報格納用テーブルの作成

コマンド一覧

コマンド一覧〔DB Utility for Biller〕

コマンド実行時の注意

コマンドによる手動開局

コマンドによる手動起動〔収納機関サービスの起動〕

コマンドによる手動起動〔通信サーバfor Billerの起動〕

コマンドによる手動取得〔収納カウンタ情報〕

コマンドの詳細

コマンドの詳細〔DB Utility for Biller〕

コマンドリファレンス（DB Utility for Biller）

コマンドを実行する前に

コマンドを実行できるユーザー

コマンドを実行できるユーザー〔DB Utility for Biller〕

コメント

(サ行)

(さ)

サーバの環境設定

再送確認SPP〔プロセスの概要〕

再送確認SPPの機能

再送確認SPPの機能

再送確認SPP用インターフェース（国庫金の場合）

再送確認SPP用インターフェース（地方税・地公体料金，一般料金の場合）

再送確認SPP用ユーザサービス定義（HMpnRes）

再送確認SPP用ユーザサービス定義（HMpnTRes）

再送確認サービス〔用語解説〕

再送確認収納業務プログラムデフォルト定義

作成手順〔消込情報格納用テーブル〕

作成手順〔国庫金消込情報格納用テーブル〕

作成手順〔国庫金対象金融機関情報格納用テーブル〕

作成手順〔国庫金納付情報格納用テーブル〕

作成手順〔収納カウンタ情報格納用テーブル〕

作成手順〔障害情報格納用テーブル〕

作成手順〔状態管理情報格納用テーブル〕

作成手順〔請求情報格納用テーブル〕

作成手順〔対象金融機関情報格納用テーブル〕

作成手順〔対象収納機関情報格納用テーブル〕

作成手順〔電文履歴格納用テーブル〕

作成手順〔納付情報格納用テーブル〕

作成手順〔ユーザーコールバック〕

作成手順〔ロウ論理ボリューム〕

サンプルファイル使用時のデータ解析方法

(し)

システム運用

システム運用〔機能概要〕

システム運用（DB Utility for Biller）

システム運用の流れ

システム環境定義（env）

システム共通定義

システム共通定義（betranrc）

システム構成の種類

システム構成の定義の特長

システム構成例

システム構築〔機能概要〕

システム構築の準備

システム構築の流れ

システム構築の流れと環境設定

システムサービス構成定義（sysconf）

システム定義

システム定義（DB Utility for Biller）

システム定義の概要

システムの管理

システムの起動手順と運用時の状態

システムの起動と停止

システムの起動と停止〔機能概要〕

システムの停止手順と運用時の状態

システムの連動起動

システムを起動/停止する前に

自動開局

自動起動〔収納機関サービスの起動〕

自動起動〔通信サーバfor Billerの起動〕

自動取得〔収納カウンタ情報〕

支払いチャネル

支払いチャネル〔用語解説〕

収納カウンタ情報〔用語解説〕

収納カウンタ情報格納用テーブル

収納カウンタ情報格納用テーブルの作成

収納カウンタ情報取得

収納カウンタ情報取得〔コマンド〕

収納カウンタ情報取得SPP〔HA構成の場合の障害と対処〕

収納カウンタ情報取得SPP〔クラスタ構成の場合の障害と対処〕

収納カウンタ情報取得SPP〔プロセスの概要〕

収納カウンタ情報取得SPP用ユーザサービス定義（HMpnCnt）

収納カウンタ情報電文〔電文の構成〕

収納カウンタ情報電文〔電文の流れ〕

収納カウンタ情報の取得〔機能概要〕

収納カウンタ情報の照会用インターフェース

収納カウンタ情報の照会要求電文の流れ

収納カウンタ情報を格納するためのユーザー用RDエリアの算出方法

収納機関が通信サーバを利用する形態

収納機関サービス〔用語解説〕

収納機関サービスの起動

収納機関サービスの起動〔コマンド〕

収納機関サービスの起動と停止〔機能概要〕

収納機関サービスの停止

収納機関サービスの停止〔コマンド〕

収納機関サービスの予備閉局

収納機関情報の変更

収納機関情報の変更〔DB Utility for Billerのコマンド〕

収納機関情報の変更〔機能概要〕

収納機関情報の変更〔コマンド〕

収納機関情報を格納するためのユーザー用RDエリアの算出方法

収納機関と通信サーバ

収納業務受付SPP〔HA構成の場合の障害と対処〕

収納業務受付SPP〔クラスタ構成の場合の障害と対処〕

収納業務受付SPP〔プロセスの概要〕

収納業務受付SPP用ユーザサービス定義（HMpnRdb）

収納業務受付インターフェース

収納業務受付インターフェースで送受信される電文〔電文の構成〕

収納業務受付インターフェースで送受信される電文〔電文の流れ〕

収納業務プログラム〔用語解説〕

収納業務プログラムが設定する項目〔消込情報の照会用インターフェース〕

収納業務プログラムが設定する項目〔収納カウンタ情報の照会用インターフェース〕

収納業務プログラムが設定する項目〔請求情報の更新用インターフェース〕

収納業務プログラムが設定する項目〔請求情報の照会用インターフェース〕

収納業務プログラムが設定する項目〔請求情報の登録用インターフェース〕

収納業務プログラムが設定する項目〔請求情報の取消用インターフェース〕

収納業務プログラムが設定する項目〔電文履歴の照会用インターフェース〕

収納業務プログラムが設定する項目〔取消情報の照会用インターフェース〕

収納業務プログラムが設定する項目〔納付情報の更新用インターフェース〕

収納業務プログラムが設定する項目〔納付情報の照会用インターフェース〕

収納業務プログラムが設定する項目〔納付情報の登録用インターフェース〕

収納業務プログラムが設定する項目〔納付情報の取消用インターフェース〕

収納業務プログラム共通定義

収納サーバ〔用語解説〕

収納サービス

収納サービス〔用語解説〕

収納サービスの提供（電文の送受信）〔機能概要〕

収納情報の消込〔機能概要〕

収納情報の再送確認〔機能概要〕

収納情報の照会〔機能概要〕

収納情報の操作〔機能概要〕

収納情報の取消〔機能概要〕

照会SPP〔プロセスの概要〕

照会SPPの機能

照会SPP用インターフェース

照会SPP用ユーザサービス定義（HMpnRef）

照会SPP用ユーザサービス定義（HMpnTRef）

障害解析用情報

障害監視対象外ユーザサーバ定義

障害監視定義

照会サービス〔用語解説〕

障害時の運用

障害時の運用〔機能概要〕

照会収納業務プログラムデフォルト定義

障害情報格納用テーブル

障害情報格納用テーブルの作成

障害情報の取得

障害情報の取得〔機能概要〕

障害発生時に取得するファイル

状態管理情報格納用テーブル

状態管理情報格納用テーブルの作成

状態管理情報を格納するためのユーザー用RDエリアの算出方法

状態管理ファイル用ロウ論理ボリューム

状態表示

状態表示〔機能概要〕

状態表示〔コマンド〕

状態表示〔用語解説〕

省略形式の電文

(す)

スーパーユーザー〔用語解説〕

(せ)

請求情報格納用テーブル

請求情報格納用テーブルの作成

請求情報通知サービス

請求情報の一括登録

請求情報の一括登録〔DB Utility for Billerのコマンド〕

請求情報の一括登録〔機能概要〕

請求情報の一括登録〔コマンド〕

請求情報の更新用インターフェース

請求情報の更新要求電文の流れ

請求情報の照会用インターフェース

請求情報の照会要求電文の流れ

請求情報の登録用インターフェース

請求情報の登録要求電文の流れ

請求情報の取消用インターフェース

請求情報の取消要求電文の流れ

請求情報を格納するためのユーザー用RDエリアの算出方法

制御電文〔電文の構成〕

制御電文〔電文の流れ〕

制御電文CUP監視プロセス〔監視概要〕

制御電文受信CUP〔HA構成の場合の障害と対処〕

制御電文受信CUP〔クラスタ構成の場合の障害と対処〕

制御電文受信CUP〔プロセスの概要〕

制御電文受信CUP監視プロセス〔プロセスの概要〕

制御ヘッダー部

制御ヘッダー部のフォーマット

セクション

セットアップ〔DB Utility for Billerのコマンド〕

セットアップ〔コマンド〕

セットアップコマンドについて

セットアップディレクトリについて

前提OS

前提条件〔DB Utility for Biller〕

前提ソフトウェア

前提ソフトウェアの環境設定

(そ)

ソフトウェア構成

(タ行)

(た)

対象金融機関情報格納用テーブル

対象金融機関情報格納用テーブルの作成

対象金融機関チェック

対象金融機関チェックのチェック項目

対象金融機関の仮想店舗機能

対象収納機関情報格納用テーブル

対象収納機関情報格納用テーブルの作成

タグ

タグについて

(ち)

地公体収納サービス

地公体収納サービス〔用語解説〕

注意事項〔DB Utility for Billerのコマンドの実行〕

注意事項〔通信サーバシステム定義〕

(つ)

通信サーバ

通信サーバBase

通信サーバBase〔環境設定〕

通信サーバBaseと通信サーバfor Biller双方でのHA構成〔HA構成の形態〕

通信サーバBaseと通信サーバfor Biller双方でのHA構成〔起動と停止〕

通信サーバfor Biller

通信サーバfor Biller CUP定義

通信サーバfor Billerが設定する項目〔消込情報の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔収納カウンタ情報の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔請求情報の更新用インターフェース〕

通信サーバfor Billerが設定する項目〔請求情報の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔請求情報の登録用インターフェース〕

通信サーバfor Billerが設定する項目〔請求情報の取消用インターフェース〕

通信サーバfor Billerが設定する項目〔電文履歴の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔取消情報の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔納付情報の更新用インターフェース〕

通信サーバfor Billerが設定する項目〔納付情報の照会用インターフェース〕

通信サーバfor Billerが設定する項目〔納付情報の登録用インターフェース〕

通信サーバfor Billerが設定する項目〔納付情報の取消用インターフェース〕

通信サーバfor Billerが設定するリターンコード〔消込SPP用インターフェース〕

通信サーバfor Billerが設定するリターンコード〔消込SPP用インターフェース〕

通信サーバfor Billerが設定するリターンコード〔再送確認SPP用インターフェース〕

通信サーバfor Billerが設定するリターンコード〔再送確認SPP用インターフェース〕

通信サーバfor Billerが送受信する電文

通信サーバfor Billerが保証する電文項目

通信サーバfor Biller共通定義

通信サーバfor Biller業務系SPP定義

通信サーバfor Biller単独でのHA構成〔HA構成の形態〕

通信サーバfor Biller単独でのHA構成〔起動と停止〕

通信サーバfor Billerのインストール

通信サーバfor Billerのインストールと環境設定

通信サーバfor Billerのインターフェース

通信サーバfor Billerの開局

通信サーバfor Billerの開局と閉局〔機能概要〕

通信サーバfor Billerの環境設定

通信サーバfor Billerの起動

通信サーバfor Billerの起動と停止〔機能概要〕

通信サーバfor Billerの機能

通信サーバfor Billerの構成

通信サーバfor Billerの障害情報

通信サーバfor Billerの障害対策

通信サーバfor Billerの停止

通信サーバfor Billerの停止〔コマンド〕

通信サーバfor Billerのプロセス構造

通信サーバfor Billerの閉局

通信サーバシステム定義

通信サーバシステム定義に指定するディレクトリおよびファイルのアクセス権

通信サーバシステム定義の概要

通信サーバシステム定義の記述例〔クラスタ構成の場合〕

通信サーバシステム定義の記述例〔通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合〕

通信サーバシステム定義の記述例〔通信サーバfor Biller単独でのHA構成の場合〕

通信サーバシステム定義の定義項目

通信サーバシステム定義の手順

通信サーバシステム定義ファイルおよびOpenTP1の定義ファイルの関連

通信サーバシステム定義ファイルの記述方法

通信サーバと共通ソフトウェアの通信形態

通信サーバの種類

(て)

定義値

定義チェック〔機能概要〕

定義値について

定義の構成と特長

定義ファイル全体について

定義ファイルの記述例（クラスタ構成の場合）

定義ファイルの記述例（通信サーバBaseと通信サーバfor Biller双方でのHA構成の場合）

定義ファイルの記述例（通信サーバfor Biller単独でのHA構成の場合）

定義名

定義名について

データ解析〔機能概要〕

データ部〔業務電文の場合〕

データ部〔収納カウンタ情報電文の場合〕

データ部〔電文保証〕

テーブルの形式〔消込情報格納用テーブル〕

テーブルの形式〔国庫金消込情報格納用テーブル〕

テーブルの形式〔国庫金対象金融機関情報格納用テーブル〕

テーブルの形式〔国庫金納付情報格納用テーブル〕

テーブルの形式〔収納カウンタ情報格納用テーブル〕

テーブルの形式〔障害情報格納用テーブル〕

テーブルの形式〔状態管理情報格納用テーブル〕

テーブルの形式〔請求情報格納用テーブル〕

テーブルの形式〔対象金融機関情報格納用テーブル〕

テーブルの形式〔対象収納機関情報格納用テーブル〕

テーブルの形式〔電文履歴格納用テーブル〕

テーブルの形式〔納付情報格納用テーブル〕

電文ID

電文の構成

電文の流れ

電文保証の概要

電文保証ポリシー

電文履歴格納用テーブル

電文履歴格納用テーブルの作成

電文履歴の照会用インターフェース

電文履歴の照会要求電文の流れ

電文履歴の保存〔機能概要〕

電文履歴を格納するためのユーザー用RDエリアの算出方法

電文を送受信するためのチェック機能

(と)

統合トレースの設定

取消SPP〔プロセスの概要〕

取消SPPの機能

取消SPP用インターフェース

取消SPP用ユーザサービス定義（HMpnCan）

取消SPP用ユーザサービス定義（HMpnTCan）

取消サービス〔用語解説〕

取消収納業務プログラムデフォルト定義

取消情報の照会用インターフェース

取消情報の照会要求電文の流れ

トレースの出力レベルとしきい値

トレースの設定

トレースファイルの見積もり

(ナ行)

(の)

納付区分エラー変換機能

納付区分ごとへの電文振り分け機能（地方税・地公体料金，国庫金の場合）

納付情報格納用テーブル

納付情報格納用テーブルの作成

納付情報の一括登録

納付情報の一括登録〔DB Utility for Billerのコマンド〕

納付情報の一括登録〔機能概要〕

納付情報の一括登録〔コマンド〕

納付情報の更新用インターフェース

納付情報の更新要求電文の流れ

納付情報の照会用インターフェース

納付情報の照会要求電文の流れ

納付情報の登録用インターフェース

納付情報の登録要求電文の流れ

納付情報の取消用インターフェース

納付情報の取消要求電文の流れ

納付情報を格納するためのユーザー用RDエリアの算出方法

(ハ行)

(ひ)

引数〔消込SPP用インターフェース〕

引数〔消込SPP用インターフェース〕

引数〔再送確認SPP用インターフェース〕

引数〔再送確認SPP用インターフェース〕

引数〔照会SPP用インターフェース〕

引数〔取消SPP用インターフェース〕

ビットマップ部〔業務電文の場合〕

ビットマップ部〔収納カウンタ情報電文の場合〕

必要なソフトウェア

(ふ)

ファイル初期化

ファイル初期化〔コマンド〕

ファイルに出力される障害情報

不正電文情報を格納するためのユーザー用RDエリアの算出方法

不正電文チェック

プロセス監視機能の概要

プロセス監視デーモン〔HA構成の場合の障害と対処〕

プロセス監視デーモン〔監視概要〕

プロセス監視デーモン〔クラスタ構成の場合の障害と対処〕

プロセス監視デーモン〔プロセスの概要〕

プロセス監視の開始と終了

プロセス監視の種類

プロセス起動時に生成されるファイル

プロセスサービス定義（prc）

プロセスの監視〔機能概要〕

(へ)

閉局〔コマンド〕

閉局〔用語解説〕

閉局待ち時間

ヘッダー部〔業務電文の場合〕

ヘッダー部〔収納カウンタ情報電文の場合〕

ヘッダー部〔制御電文の場合〕

ヘッダー部〔電文保証〕

(マ行)

(め)

メッセージの出力について

(も)

文字コード変換機能定義

(ヤ行)

(ゆ)

ユーザーコールバック〔用語解説〕

ユーザーコールバックインターフェース

ユーザーコールバックインターフェース（DB Utility for Biller）

ユーザーコールバックインターフェース（一般料金用）

ユーザーコールバックインターフェース（国庫金用）

ユーザーコールバックインターフェース（地方税・地公体料金用）

ユーザーコールバックが呼び出されるタイミング

ユーザーコールバックの作成

ユーザーコールバックの役割

ユーザサービスデフォルト定義（usrrc）

ユニット制御情報定義

(よ)

予備系〔用語解説〕

予備閉局

予備閉局〔用語解説〕

(ラ行)

(れ)

レスポンスコード

(ろ)

ロウ論理ボリュームの作成

ロウ論理ボリューム名の設定

ログサービス定義（log）

■ 商標類

AIXは，米国における米国International Business Machines Corp.の登録商標です。
HP-UXは，米国Hewlett-Packard Companyのオペレーティングシステムの名称です。
ORACLEは，米国Oracle Corporation の登録商標です。
Oracleは，米国Oracle Corporation及びその子会社，関連会社の登録商標です。
Oracle9iは，米国Oracle Corporationの商標です。
UNIXは，X/Open Company Limitedが独占的にライセンスしている米国ならびに他の国における登録商標です。
Windowsは，米国およびその他の国における米国Microsoft Corp.の登録商標です。
XATMIは，X/Open Company Limitedが開発したアプリケーションインタフェースの名称です。
マルチペイメントネットワーク共通ソフトウェアの著作権は株式会社NTTデータに帰属します。