OpenTP1 Version 7　TP1/Messaging 使用の手引

解説・手引・操作書

3000-3-D61-11

前書き

対象製品

P-2464-3364 uCosminexus TP1/Messaging 07-51（適用OS：Windows Server 2012，Windows Server 2012 R2，Windows Server 2016，Windows Server 2019，Windows 8.1，Windows 10）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，OpenTP1，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

Microsoftは，マイクロソフト 企業グループの商標です。

UNIXは，The Open Groupの登録商標です。

Windowsは，マイクロソフト 企業グループの商標です。

Windows Serverは，マイクロソフト 企業グループの商標です。

その他記載の会社名、製品名などは、それぞれの会社の商標もしくは登録商標です。

発行

2022年 4月 3000-3-D61-11

著作権

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

変更内容

変更内容（3000-3-D61-11） uCosminexus TP1/Messaging 07-51

追加・変更内容

変更個所

TP1/NET/High Availabilityの説明を追加しました。

1.1

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

変更内容（3000-3-D61-10） uCosminexus TP1/Messaging 07-51

追加・変更内容

TP1/Messaging - Extension 1の説明を追加しました。

TP1/Messagingの前提プログラムを削除しました。

MHP環境設定GUIが生成する定義ソースファイルの説明を追加しました。

GUIが生成しない定義ソースファイルの説明を追加しました。

新規サポートのオプション，オペランド，および指定値を追加しました。

ユーザサービス定義の説明を追加しました。

システムサービス共通情報定義の説明を追加しました。

MCF性能検証用トレース定義の説明を追加しました。

リアルタイム取得項目定義の説明を追加しました。

新規サポートの運用コマンドを追加しました。

TP1/MessagingとMCFの差異に関する説明を追加しました。

次に示すバージョンの変更点を記載しました。

TP1/Messaging 07-51

はじめに

このマニュアルは，プログラムプロダクトuCosminexus TP1/Messagingの概要と使用方法について説明したものです。

対象読者

Windowsが組み込まれているシステム環境の下でuCosminexus TP1/Messagingを運用するシステム管理者の方を対象としています。

マニュアルの構成

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

第1章　概要

TP1/Messagingの概要と機能について説明しています。

第2章　環境設定

TP1/Messagingの具体的な環境設定の方法について説明しています。

第3章　オペレーション

TP1/Messagingの運用操作の方法について説明しています。

第4章　トラブルが発生したら

TP1/Messaging運用中に発生するトラブルと，その対処方法について説明しています。

付録A　TP1/MessagingとMCFの差異

TP1/MessagingとMCFの機能，定義，運用コマンド，および関数の差異について説明しています。

付録B　バージョンアップ時の変更点

各バージョンでのGUI，および定義の変更点について説明しています。

付録C　サンプルプログラム

TP1/MessagingのUAPを作成するためのサンプルプログラムについて説明しています。

付録D　用語解説

TP1/Messagingで使用する用語について説明しています。

関連マニュアル

OpenTP1の関連マニュアルには，TP1/Messagingで使用できない機能，定義，運用コマンド，および関数について説明している個所があります。関連マニュアルのうち，TP1/Messagingで使用できない機能，定義，運用コマンド，および関数については，「付録A　TP1/MessagingとMCFの差異」を参照してください。

読書手順

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

図中で使用する記号

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

文法の記号

（1）文法記述記号

文法の記述記号について説明する記号です。

文法記述記号

意味

｜

（ストローク）

この記号で仕切られた項目は，選択できることを示します。

（例）サーバ｜クライアント

サーバまたはクライアントのうち，どちらかを選択できることを示します。

△

（白三角）

半角スペースを示します。

（例）CBLDCMCF('OPEN△△△△')

'OPENと'の間に，半角スペースを4個入力することを示します。

（2）属性表示記号

ユーザ指定値の範囲などを説明する記号です。

属性表示記号

意味

《　》

ユーザが指定を省略したときに仮定される値を示します。

〈　〉

ユーザ指定値の構文要素を示します。

((　))

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

［　］

GUIの画面に表示されるボックス，ボタンなどを示します。

【　】

GUIで値を設定する場合の初期値を示します。

（3）構文要素記号

ユーザ指定値の内容を説明する記号です。

構文要素記号

意味

英字

アルファベット（A〜Z，a〜z），および＿（アンダスコア）の文字

英数字

英字と数字（0〜9）

符号なし整数

数字（0〜9）

識別子

先頭がアルファベット（A〜Z，a〜z）で始まる英数字列

文字列

任意の文字の配列

パス名

記号名称，／，および　．（ピリオド）

（ただし，パス名は使用するOSに依存）

＜ホスト名＞

先頭が英数字または-（ハイフン）で，先頭以外が英数字，-（ハイフン），または.（ピリオド）

このマニュアルでの表記

このマニュアルで使用する製品名称の略称を次に示します。

名称

略称

uCosminexus TP1/Client for .NET Framework

TP1/Client

uCosminexus TP1/Client/J

uCosminexus TP1/Client/P

uCosminexus TP1/Client/P(64)

uCosminexus TP1/Client/W

uCosminexus TP1/Client/W(64)

uCosminexus TP1/High Availability

TP1/High Availability

uCosminexus TP1/LiNK

TP1/LiNK

uCosminexus TP1/Message Control

TP1/Message Control

uCosminexus TP1/Messaging

TP1/Messaging

uCosminexus TP1/Messaging - Extension 1

TP1/Messaging - Extension 1

uCosminexus TP1/NET/High Availability

TP1/NET/High Availability

uCosminexus TP1/NET/Library

TP1/NET/Library

uCosminexus TP1/NET/TCP/IP

TP1/NET/TCP/IP

uCosminexus TP1/Server Base

TP1/Server Base

Windows 8.1 Enterprise (x86)

Windows 8.1

Windows 8.1 Pro (x86)

Windows 8.1 Enterprise (x64)

Windows 8.1 Pro (x64)

Windows 10 Enterprise (x86)

Windows 10

Windows 10 Pro (x86)

Windows 10 Enterprise (x64)

Windows 10 Pro (x64)

Microsoft Windows Server 2012 Datacenter

Windows Server 2012

Microsoft Windows Server 2012 Standard

Microsoft Windows Server 2012 R2 Datacenter

Windows Server 2012 R2

Microsoft Windows Server 2012 R2 Standard

Microsoft Windows Server 2016 Datacenter

Windows Server 2016

Microsoft Windows Server 2016 Standard

Microsoft Windows Server 2019 Datacenter

Windows Server 2019

Microsoft Windows Server 2019 Standard

表中のOS間で機能差がない場合，Windowsと表記しています。

略語一覧

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

英略語

英字での表記

FAT

File Allocation Table

GUI

Graphical User Interface

MCF

TP1/Message Control (Facility)

MHP

Message Handling Program

NTFS

New Technology File System

OSI

Open Systems Interconnection

PC

Personal Computer

SPP

Service Providing Program

SUP

Service Using Program

TCP/IP

Transmission Control Protocol/Internet Protocol

UAP

User Application Program

UOC

User Own Coding

WS

Workstation

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

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

1　概要

この章では，TP1/Messagingの概要と機能について説明します。

1.1　TP1/Messagingの概要

TP1/Messagingは，Windowsを組み込んだシステム環境で，OpenTP1のメッセージ制御をする製品です。TP1/LiNKがあらかじめ組み込まれている環境で動作し，TCP/IP通信機能を使用したオンラインシステムを構築できます。

さらに，TP1/Messaging - Extension 1をインストールすれば，TP1/Messagingの機能を拡張できます。TP1/Messaging - Extension 1が必要な定義，運用コマンド，および関数については，「付録A　TP1/MessagingとMCFの差異」を参照してください。

TP1/Messagingのシステムでの位置づけを次の図に示します。

図1‒1　システムでの位置づけ

注※1

TP1/Messagingで扱うUAPは，MHPおよびSPPです。UAPについては，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

注※2

コネクション切り替え機能を使うときに必要な製品です。コネクション切り替え機能については，マニュアル「OpenTP1 プロトコル TP1/NET/TCP/IP編」を参照してください。

注※3

系切り替え機能を使うときに必要な製品です。系切り替え機能については，マニュアル「OpenTP1 解説」を参照してください。

TP1/Messagingを使用すると，WSサーバで動作しているOpenTP1のメッセージ制御機能（MCF）や，OpenTP1のクライアント機能（TP1/Client）と，TCP/IPプロトコルで接続できます。

TP1/Messagingを組み込んだシステムは，複雑なシステム構成を行う必要がありません。また，同じシステム構成を持つPCを，サーバとしてもクライアントとしても使用できます。そのため，柔軟なオンラインネットワークを構築できます。

TP1/Messagingを使用したオンラインネットワークの概要を次の図に示します。

図1‒2　オンラインネットワークの概要

1.2　TP1/Messagingの機能

この節では，TP1/Messagingの機能について説明します。

1.2.1　GUI機能

TP1/Messagingでは，Windowsの画面に表示されたボタンの絵をクリックすることで，設定する値を入力したり，運用操作をしたりできます。これをGUI（グラフィカルユーザインタフェース）といいます。GUIを使用すると，設定などの作業が効率的に行えます。

また，GUIを使用しないで，コマンドプロンプトからコマンドを入力することもできます。

TP1/Messagingでは，次のGUI機能を使用できます。

MCF環境設定GUI，MHP環境設定GUI

TP1/Messagingの実行環境を設定するときに表示されます。

MCFオペレーションGUI，MHPオペレーションGUI

TP1/Messagingの運用操作をするときに表示されます。

GUIを使用した設定方法，および操作方法については，「2.　環境設定」，「3.　オペレーション」を参照してください。

1.2.2　資源自動見積もり機能

TP1/Messagingでは，TP1/Messagingが動作するために必要な資源の容量を，自動的に見積もり，割り当てます。TP1/Messagingで必要となる資源は，共用メモリとステータスファイルです。

共用メモリとは，複数のプロセスで共有して，データの参照や更新をするメモリです。主に，TP1/Messagingを制御するテーブル，および共用のバッファのために領域が取られます。共用メモリには，固定的なデータを格納するための静的共用メモリと，必要に応じて使用する動的共用メモリの2種類があります。

ステータスファイルは，TP1/Messagingの状態（ステータス）を示す情報を格納しておくファイルです。

TP1/Messagingでは，システム起動時に，上記の資源を自動的に確保します。ただし，TP1/Messagingを使用する状況によっては，共用メモリが不足する場合があります。オンライン中に共用メモリが不足した場合は，作業を中断し，直ちに保守員へ連絡してください。

2　環境設定

環境設定とは，TP1/Messagingを運用する前に行う，準備作業をいいます。この章では，TP1/Messagingの環境設定の詳細について説明します。

2.1　環境設定をする前に

TP1/Messagingの実行環境を設定する前に，行っておく作業について説明します。

TP1/Messagingの環境設定の手順を，次の図に示します。

図2‒1　環境設定の手順

2.2　アプリケーションの準備

業務処理に必要なアプリケーションプログラムを準備する手順について説明します。

2.2.1　作業の流れ

TP1/Messagingのアプリケーションプログラムを準備する手順について説明します。

TP1/MessagingのアプリケーションプログラムとしてMHP（メッセージ処理プログラム）を作成することができます。MHPの詳細については，マニュアル「OpenTP1 プログラム作成の手引」を参照してください。

アプリケーションの準備の手順を次の図に示します。

図2‒2　アプリケーションの準備の手順

(1)　コーディング

MHPのサービス関数およびメイン関数をC言語，またはCOBOL言語で作成します。コーディングの詳細に関しては，次に示すOpenTP1のマニュアルを参照してください。

「OpenTP1 プログラム作成の手引」

「OpenTP1 プログラム作成リファレンス C言語編」

「OpenTP1 プログラム作成リファレンス COBOL言語編」

(2)　MHP環境設定

MHPをTP1/Messagingで実行するための環境を設定します。MHPはTP1/LiNK上でサービスを提供するユーザサーバに当たるものです。MHPの環境設定は，GUI画面から行います。MHP管理画面のユーザサーバ環境設定画面で設定してください。

MHPの環境設定内容を保存すると，それぞれのMHPに対して，スタブソースファイルが作成されます。スタブソースファイルは，%DCDIR%¥APLIB¥ディレクトリの下に，×××_sstb.cという名称で作成されます。×××はMHPのユーザサーバ名を示します。このスタブソースファイルは，C言語で記述されています。

MHPの環境設定の詳細については，「2.3.1　GUIによる環境設定」を参照してください。

(3)　コンパイルとリンケージ

MHPのサービス関数，メイン関数，およびスタブソースファイルをコンパイルし，オブジェクトファイルと，トランザクション制御用オブジェクトファイルをリンケージしてMHPの実行形式ファイルを作成します。実行形式ファイル名は，MHP環境設定画面で設定したプログラム名に拡張子（.EXE）を付けた名称としてください。MHPの実行形式ファイルは%DCDIR%¥APLIB¥ディレクトリの下に格納してください。

(4)　MCFアプリケーションの環境設定

MHPのサービス関数をMCFのアプリケーションとして登録します。MCFアプリケーション名は，MCFで受け取ったメッセージを処理するときに，該当するメッセージを処理するアプリケーションであることを識別する名称です。MCFアプリケーションの環境設定は，GUIの画面のMCF環境設定画面で，MCFアプリケーション環境設定画面またはMCFアプリケーション定義ソース編集で行ってください。

MCF環境設定GUIで環境設定をする場合は，1個以上のMCFアプリケーションを1個のMCFアプリケーショングループとして定義します。このアプリケーショングループ名称は，MCF通信サービスとの対応づけに使います。MCFアプリケーション環境設定の詳細は，「2.3.1　GUIによる環境設定」を参照してください。

コマンドプロンプト画面から，MCFアプリケーション定義ソースファイルを編集して環境設定をする場合は，1個以上のMCFアプリケーションを1個のMCFアプリケーション定義ソースファイルの中で定義してください。MCFアプリケーション定義ソースファイルは，定義変換コマンドを使用してMCFアプリケーション定義オブジェクトファイルに変換する必要があります。この定義オブジェクトファイル名は，MCF通信サービスとの対応づけに使います。詳細については，「2.3.2　定義ソースファイル編集による環境設定」，およびマニュアル「OpenTP1 システム定義」を参照してください。

(5)　MCF通信サービスとアプリケーションの対応づけ

MCF通信サービス（TCP/IP通信サービスおよびアプリケーション間通信サービス）がどのアプリケーションを使用するかを定義します。

MCF環境設定GUIで環境設定をする場合は，MCF環境設定GUIを使用します。MCFの通信サービス環境設定画面中のアプリケーショングループ名欄に，MCFアプリケーションの環境設定で定義したMCFアプリケーショングループ名称を設定してください。それによって，通信サービスとアプリケーショングループが対応づけられます。1個のアプリケーショングループを複数の通信サービスに対応づけることができます。MCF通信サービス環境設定の詳細については，「2.3.1　GUIによる環境設定」を参照してください。

定義ソースファイルを編集して環境設定をする場合は，MCF通信構成定義共通部のMCFアプリケーション定義オブジェクトファイル名に，MCFアプリケーション定義ソースファイルから作成した定義オブジェクトファイル名を指定します。それによって，MCF通信サービスとMCFアプリケーション定義ソースが対応づけられます。詳細については，「2.3.2　定義ソースファイル編集による環境設定」，およびマニュアル「OpenTP1 システム定義」を参照してください。

(6)　TP1/LiNK起動

TP1/LiNKオペレーションGUIからTP1/LiNKを起動すると，MCF通信サーバ，および自動起動設定されたMHPユーザサーバが引き続き起動されます。詳細については，「3.1　TP1/Messagingの起動と停止」，およびマニュアル「TP1/LiNK 使用の手引」を参照してください。

(7)　MHPユーザサーバの起動

MHPユーザサーバを手動起動する場合は，GUI画面のMHP管理画面から起動してください。

詳細については，「3.3　MHPのオペレーション」を参照してください。

2.3　実行環境の設定

TP1/Messagingの実行環境の設定について説明します。

TP1/Messagingでは，環境設定の方法として，GUIによる環境設定と，定義ソースファイル編集による環境設定とが選択できます。

なお，TP1/Messagingの環境設定をするときには，TP1/LiNKの環境があらかじめ設定されている必要があります。TP1/LiNKの環境設定については，マニュアル「TP1/LiNK 使用の手引」を参照してください。

2.3.1　GUIによる環境設定

TP1/Messagingでは，セットアップ完了時に，実行環境が初期設定されます。TP1/Messaging環境設定を起動すると，GUIの画面が表示されます。ボタンで任意の画面を選択し，初期設定された実行環境を実際の実行環境に変更してから，TP1/Messagingを開始してください。一度設定した実行環境を変更する場合は，画面を再度表示させ，変更したい項目を再設定してください。

GUIで設定するTP1/Messagingの環境設定項目を次の表に示します。

表2‒1　TP1/Messagingの環境設定項目（GUIによる設定の場合）

設定種別

設定項目

内容

MCF環境設定

アプリケーショングループ環境設定およびアプリケーション属性設定

通信サービスを使用するアプリケーションの実行環境を設定します。

アプリケーション間通信環境設定

ノード内通信のための通信サービスの実行環境を設定します。

TCP/IP通信環境設定およびTCP/IPコネクション属性設定

TCP/IPプロトコルを使用して外部通信をするための実行環境を設定します。

MHP環境設定

MHPユーザサーバ環境設定

TP1/Messagingを使用してメッセージ送受信をするMHPユーザサーバの実行環境を設定します。

ユーザサーバ自動起動順位の設定

ユーザサーバの自動起動の有無と，自動起動する場合の起動順位を設定します。

MCF環境設定時の画面構成について，次の図に示します。

図2‒3　MCF環境設定時の画面構成

(1)　MCF環境設定

まず，TP1/Messaging環境設定を起動すると，開始画面が表示されます。

開始画面に表示されている項目について説明します。

アプリケーショングループ環境設定欄

［アプリケーショングループ名（G）］リストボックス

TP1/Messagingで定義しているアプリケーショングループ名を表示します。

［追加（B）］ボタン

［アプリケーショングループ名（G）］リストボックスに新規のアプリケーショングループ名を追加します。

［詳細設定（E）］ボタン

このボタンをクリックすると，アプリケーショングループ環境設定画面が表示されます。

アプリケーショングループ環境設定画面で行う詳細設定については，「2.3.1(1)(a)　アプリケーショングループ環境設定」を参照してください。

［削除（I）］ボタン

リストボックスで選択されているアプリケーショングループを削除します。

アプリケーション間通信環境設定欄

［アプリケーション間通信サービス名（P）］リストボックス

TP1/Messagingで定義しているアプリケーション間通信サービスを表示します。

［追加（J）］ボタン

［アプリケーション間通信サービス名（P）］リストボックスに新規のアプリケーション間通信サービス名を追加します。

［詳細設定（K）］ボタン

このボタンをクリックすると，アプリケーション間通信環境の詳細設定画面が表示されます。

アプリケーション間通信環境設定画面での設定の詳細については，「2.3.1(1)(c)　アプリケーション間通信環境設定」を参照してください。

［削除（L）］ボタン

リストボックスで選択されているアプリケーション間通信サービス名を削除します。

TCP/IP通信環境設定欄

［TCP/IP通信サービス名（T）］リストボックス

TP1/Messagingで定義しているTCP/IP通信サービスを表示します。

［追加（M）］ボタン

［TCP/IP通信サービス名（T）］リストボックスに新規のTCP/IP通信サービス名を追加します。

［詳細設定（N）］ボタン

このボタンをクリックすると，TCP/IP通信サービス環境の詳細設定画面が表示されます。

TCP/IP通信サービス環境設定画面での設定の詳細については，「2.3.1(1)(d)　TCP/IP通信サービス環境設定」を参照してください。

［削除（O）］ボタン

リストボックスで選択されているTCP/IP通信サービス名を削除します。

［終了（C）］ボタン

MCFの環境設定を終了します。

設定内容が変更されている場合は，「定義内容変更確認メッセージ」のダイアログが表示されます。設定内容を変更して終了する場合は［はい（Y）］ボタンを，変更しないで終了する場合は［いいえ（N）］ボタンをクリックします。また，終了を取り消す場合は，［キャンセル］ボタンをクリックします。

メニューバー

［ファイル（F）］メニュー

このメニューから［終了（C）］を選択すると，環境設定を終了します。

［ヘルプ（H）］メニュー

このメニューから［バージョン情報］を選択すると，TP1/Messagingのバージョン情報が表示されます。

開始画面で設定する項目について，次の表に示します。

表2‒2　開始画面で設定する項目

項目名

指定値

対応する定義

アプリケーショングループ名

〈1〜8文字の識別子〉

指定数：1〜16

mcfaenv -a

【mcfagnn】（nn：整数）

アプリケーション間通信サービス名

〈先頭が_muで始まる1〜8文字の識別子〉

指定数：0〜1

mcftenv -a

【_mupsnn】（nn：整数）

TCP/IP通信サービス名

〈先頭が_muで始まる1〜8文字の識別子〉

指定数：1〜16

mcftenv -a

【_mutcnn】（nn：整数）

(a)　アプリケーショングループ環境設定

開始画面のアプリケーショングループ環境設定欄でアプリケーショングループ名を選択したあと，［詳細設定（E）］ボタンをクリックすると，アプリケーショングループ環境設定画面が表示されます。

アプリケーショングループ環境設定画面に表示されている項目を，次に示します。

［アプリケーショングループ名（G）］テキストボックス

開始画面で選択したアプリケーショングループ名が表示されます。

アプリケーション名を変更したい場合は，テキストボックスに名称を直接入力します。アプリケーショングループ名には，英字の大文字と小文字の区別はありません。例えばmcfag01とmcfAG01は同じアプリケーショングループ名になります。

アプリケーション属性設定欄

［アプリケーション名（P）］リストボックス

選択したアプリケーショングループに属するアプリケーション名を表示します。

［追加（A）］ボタン

アプリケーショングループに新しいアプリケーションを一つ追加します。リストボックスには，追加されたアプリケーション名が表示されます。

追加するアプリケーションには，該当するアプリケーショングループ内で重複しない名称（一意名）を付けてください。

［詳細設定（T）］ボタン

このボタンをクリックすると，リストボックスで選択されているアプリケーションのアプリケーション属性設定画面が表示されます。

アプリケーション属性設定画面の詳細については，「2.3.1(1)(b)　アプリケーション属性設定」を参照してください。

［削除（D）］ボタン

リストボックスで選択されているアプリケーションを，該当するアプリケーショングループから削除します。

［終了（C）］ボタン

アプリケーショングループ環境設定を終了します。

アプリケーショングループ環境設定画面で設定する項目について，次の表に示します。

表2‒3　アプリケーショングループ環境設定画面で設定する項目

項目名

指定値

対応する定義

アプリケーショングループ名

〈1〜8文字の識別子〉

mcfaenv -a

【mcfagnn】（nn：整数）

アプリケーション名

〈1〜8文字の識別子〉

指定数：1〜64

mcfaalcap -n

【mcfapnn】（nn：整数）

(b)　アプリケーション属性設定

アプリケーショングループ環境設定画面の［アプリケーション名（P）］欄でアプリケーション名を選択したあと，［詳細設定（T）］ボタンをクリックすると，アプリケーション属性設定画面が表示されます。

アプリケーション属性設定画面に表示されている項目について説明します。

［アプリケーション名（A）］テキストボックス

アプリケーショングループ環境設定画面で選択したアプリケーション名を表示します。アプリケーション名を変更する場合は，このテキストボックスに新しいアプリケーション名を直接入力します。アプリケーション名には，英字の大文字と小文字の区別はありません。例えばmcfap01とmcfAP01は同じアプリケーション名になります。

［アプリケーションの種別］オプションボタン

［アプリケーション名（A）］テキストボックスに表示されているアプリケーションの種別を表示します。種別を変更する場合は，この欄にあるオプションボタンの中から，選択する種別をクリックします。

［アプリケーションの型］オプションボタン

［アプリケーション名（A）］テキストボックスに表示されているアプリケーションの型を表示します。型を変更する場合は，この欄にあるオプションボタンの中から，選択する種別をクリックします。ただし，TP1/Messagingでは，応答型，および継続問い合わせ応答型は選択できません。

［サービスグループ名（G）］テキストボックス

［アプリケーション名（A）］テキストボックスに表示されているアプリケーションに対応するサービスが属するサービスグループ名を表示します。サービスグループ名を変更する場合は，このテキストボックスに新しいサービスグループ名を直接入力します。

［サービス名（S）］テキストボックス

［アプリケーション名（A）］テキストボックスに表示されているアプリケーションに対応するサービス名を表示します。サービス名を変更する場合は，このテキストボックスに新しいサービス名を直接入力します。

［トランザクション機能（T）］チェックボックス

アプリケーションで，トランザクション機能を使用するかどうかを表示します。使用する場合は，ボックスにチェック（×印）を表示させ，使用しない場合は空白にします。チェック表示は，ボックスをクリックして行います。

［終了（C）］ボタン

アプリケーション属性設定を終了し，アプリケーショングループ環境設定の画面に戻ります。

このボタンをクリックしたとき，アプリケーション属性設定の内容に誤りがある場合は，エラーメッセージのダイアログが表示されます。

エラーメッセージの内容を確認後，ダイアログ内の［OK］ボタンをクリックすると，ダイアログの表示が消え，アプリケーション属性設定画面に戻ります。

設定内容がすべて正しい場合は，アプリケーション属性設定を終了し，アプリケーショングループ環境設定の画面に戻ります。

アプリケーション属性設定画面で設定する項目を次の表に示します。

表2‒4　アプリケーション属性設定画面で設定する項目

項目名

指定値

対応する定義

アプリケーション名

〈1〜8文字の識別子〉

mcfaalcap -n name

【mcfapnn】（nn：整数）

アプリケーションの種別

ユーザのアプリケーション｜MCFイベント

（オプションボタンで選択）

mcfaalcap -n kind

アプリケーションの型

非応答型

mcfaalcap -n type

サービスグループ名

〈1〜31文字の識別子〉

mcfaalcap -g servgrpn

【mhpsgnn】（nn：整数）

サービス名

〈1〜31文字の識別子〉

mcfaalcap -v servname

【mhpsvnn】（nn：整数）

(c)　アプリケーション間通信環境設定

開始画面のアプリケーション間通信環境設定欄でアプリケーション間通信サービス名を選択したあと，［詳細設定（K）］ボタンをクリックすると，アプリケーション間通信環境設定画面が表示されます。

アプリケーション間通信環境設定画面に表示されている項目について説明します。

［アプリケーション間通信サービス名（S）］テキストボックス

開始画面で選択したアプリケーション間通信サービス名と同じ名称を表示します。アプリケーション間通信サービス名を変更する場合は，このテキストボックスに新しいサービス名を直接入力します。アプリケーション間通信サービス名には，英字の大文字と小文字の区別はありません。例えば_mups01と_muPS01は同じアプリケーション間通信サービス名になります。

［実行形式プログラム名（E）］テキストボックス

テキストボックスに表示されているアプリケーション間通信サービスの実行形式プログラム名を表示します。この名称は，変更できません。

［アプリケーション間通信サービス識別子（I）］テキストボックス

テキストボックスに表示されているアプリケーション間通信サービスの識別子を表示します。この識別子は変更できません。

［アプリケーショングループ名（G）］テキストボックス

テキストボックスに表示されているアプリケーション間通信サービスに対応するアプリケーショングループ名を表示します。アプリケーショングループ名を変更する場合は，このテキストボックスに新しい名称を直接入力します。

［内部通信路名（P）］テキストボックス

テキストボックスに表示されているアプリケーション間通信サービスに対応する内部通信路名を表示します。内部通信路名を変更する場合は，このテキストボックスに新しい名称を直接入力します。

論理端末属性欄

［論理端末名（L）］リストボックス

テキストボックスに表示されているアプリケーション間通信サービスの論理端末名を表示します。論理端末名は，変更できません。

このリストボックスには，最大二つの論理端末名を設定できます。

［追加（A）］ボタン

リストボックスに論理端末名を一つ追加します。

［削除（D）］ボタン

リストボックスから，選択されている論理端末名を削除します。

［端末タイプ］オプションボタン

リストボックスで選択されている論理端末の端末タイプを表示します。

一方送信型だけ指定できます。

［終了（C）］ボタン

アプリケーション間通信環境設定を終了し，開始画面に戻ります。

このボタンをクリックしたとき，アプリケーション間通信環境設定の内容に誤りがある場合は，エラーメッセージのダイアログが表示されます。

エラーメッセージの内容を確認後，ダイアログ内の［OK］ボタンをクリックすると，ダイアログの表示が消え，アプリケーション間通信環境設定画面に戻ります。

設定内容がすべて正しい場合は，アプリケーション間通信環境設定を終了し，開始画面に戻ります。

アプリケーション間通信環境設定画面で設定する項目を次の表に示します。

表2‒5　アプリケーション間通信環境設定画面で設定する項目

項目名

指定値

対応する定義

アプリケーション間通信サービス名

〈_muで始まる1〜8文字の識別子〉

定義オブジェクトファイル名

【_mupsnn】（nn：整数）

アプリケーショングループ名

〈1〜8文字の識別子〉

mcftenv -a

【mcfagnn】（nn：整数）

内部通信路名

〈1〜8文字の識別子〉

mcftpsvr -c

【cpsvnn】（nn：整数）

論理端末名

〈1〜8文字の識別子〉

指定数：1〜2

mcftalcle -l

【psvlenn】（nn：整数）

端末タイプ

一方送信型

mcftalcle -t

(d)　TCP/IP通信サービス環境設定

開始画面のTCP/IP通信環境設定欄でTCP/IP通信サービス名を選択したあと，［詳細設定（N）］ボタンをクリックすると，TCP/IP通信サービス環境設定画面が表示されます。

TCP/IP通信サービス環境設定画面に表示されている項目について説明します。

［TCP/IP通信サービス名（S）］テキストボックス

開始画面で選択したTCP/IP通信サービス名と同じ名称を表示します。TCP/IP通信サービス名を変更する場合は，このテキストボックスに新しいサービス名を直接入力します。TCP/IP通信サービス名には，英字の大文字と小文字の区別はありません。例えば_mutc01と_muTC01は同じTCP/IP通信サービス名になります。

［実行形式プログラム名（E）］テキストボックス

テキストボックスに表示されているTCP/IP通信サービスの実行形式プログラム名を表示します。この名称は，変更できません。

［通信サービス識別子（I）］テキストボックス

テキストボックスに表示されているTCP/IP通信サービスの通信サービス識別子を表示します。この名称は，変更できません。

［アプリケーショングループ名（G）］テキストボックス

テキストボックスに表示されているTCP/IP通信サービスに対応するアプリケーショングループ名を表示します。アプリケーショングループ名を変更する場合は，このテキストボックスに新しい名称を直接入力します。

［ユーザメッセージ長］オプションボタン

TCP/IP通信サービスで1回に送受信するユーザメッセージの長さを表示します。ユーザメッセージ長を変更する場合は，オプションボタンの中からどれかを選択し，ボタンをオンにします。

コネクション属性欄

［コネクション名（N）］リストボックス

TCP/IP通信サービスのコネクション名の一覧が表示されます。

［追加（A）］ボタン

TCP/IP通信サービスに新しいコネクションを一つ追加します。リストボックスには，追加されたコネクション名が表示されます。

［詳細設定（T）］ボタン

このボタンをクリックすると，リストボックスで選択されているコネクションのコネクション属性設定画面が表示されます。

コネクション属性設定画面の詳細については，「2.3.1(1)(e)　TCP/IPコネクション属性設定」を参照してください。

［削除（D）］ボタン

リストボックスで選択されているコネクションを削除します。

［終了（C）］ボタン

TCP/IP通信サービス環境設定を終了し，開始画面に戻ります。

このボタンをクリックしたとき，TCP/IP通信サービス環境設定の内容に誤りがある場合は，エラーメッセージのダイアログが表示されます。

エラーメッセージの内容を確認後，ダイアログ内の［OK］ボタンをクリックすると，ダイアログの表示が消え，TCP/IP通信サービス環境設定画面に戻ります。

設定内容がすべて正しい場合は，TCP/IP通信サービス環境設定を終了し，開始画面に戻ります。

TCP/IP通信サービス環境設定画面で設定する項目を次の表に示します。

表2‒6　TCP/IP通信サービス環境設定画面で設定する項目

項目名

指定値

対応する定義

TCP/IP通信サービス名

〈_muで始まる1〜8文字の識別子〉

定義オブジェクトファイル名

【_mutcnn】（nn：整数）

アプリケーショングループ名

〈1〜8文字の識別子〉

mcfaenv -a

【mcfagnn】（nn：整数）

ユーザメッセージ長

4キロバイト｜16キロバイト｜32キロバイト

（オプションボタンで選択）

mcftbuf -g length

コネクション名

〈1〜8文字の識別子〉

指定数：1〜16

mcftalccn -c

【ctcpnn】（nn：整数）

(e)　TCP/IPコネクション属性設定

TCP/IP通信サービス環境設定画面の［TCP/IP通信サービス名（S）］テキストボックスでTCP/IP通信サービス名を選択したあと，［詳細設定（T）］ボタンをクリックすると，TCP/IPコネクション属性設定画面が表示されます。

TCP/IPコネクション属性設定画面に表示されている項目について説明します。

［コネクション名（N）］テキストボックス

開始画面のコネクション属性欄で選択したコネクション名と同じ名称を表示します。コネクション名を変更する場合は，このテキストボックスに新しいコネクション名を直接入力します。コネクション名には，英字の大文字と小文字の区別はありません。例えばctcp01とctCP01は同じコネクション名になります。

［論理端末名（L）］テキストボックス

テキストボックスに表示されているコネクションに対応する論理端末名を表示します。論理端末名を変更する場合は，このテキストボックスに新しい論理端末名を直接入力します。

［アプリケーション名（A）］テキストボックス

メッセージを受信した場合に起動するアプリケーション名を表示します。テキストボックスに，アプリケーション名を直接入力してください。なお，このテキストボックスの設定は省略できます。

［確立モード］オプションボタン

自システムのコネクション確立モードを表示します。確立モードを変更する場合は，オプションボタンの中から選択し，ボタンをオンにします。

［コネクションの自動確立］オプションボタン

自システムがクライアントの場合，OpenTP1システム開始時にコネクションの自動確立をするかどうかを表示します。オプションボタンの中から選択し，ボタンをオンにします。なお，自システムがサーバの場合は，ボタンは選択できません。

［コネクションリプレースの使用］オプションボタン

自システムがサーバの場合に，コネクションリプレースを使用するかどうかを指定します。なお，自システムがクライアントの場合は，ボタンは選択できません。

自システム属性欄

［ポート番号］オプションボタン，［任意のポート番号］オプションボタン

自システムがサーバの場合に，ポート番号の属性を表示します。ポート番号の属性を変更する場合は，オプションボタンの中から選択し，ボタンをオンにします。

相手システム属性欄

［ホスト名称設定］テキストボックス

hostsファイルに記述してある相手システムのホスト名称を表示します。ホスト名称を変更する場合は，テキストボックスに新しい名称を直接入力してください。

［IPアドレス指定］テキストボックス

相手システムのIPアドレスを直接入力してください。

ホスト名称，およびIPアドレスは，該当するオプションボタンをオンにしてから指定します。

［ポート番号］オプションボタン，［ポート番号Free］オプションボタン

ポート番号を選択したときに，相手システムのポート番号の属性を表示します。属性を変更する場合は，該当するオプションボタンを選択します。なお，［ポート番号Free］オプションボタンは，自システムがサーバの場合だけ選択できます。

［終了（C）］ボタン

TCP/IPコネクション属性設定を終了します。

このボタンをクリックしたとき，TCP/IPコネクション属性設定の内容に誤りがある場合は，エラーメッセージのダイアログが表示されます。

エラーメッセージの内容を確認後，ダイアログ内の［OK］ボタンをクリックすると，ダイアログの表示が消え，TCP/IPコネクション属性設定画面に戻ります。

設定内容がすべて正しい場合は，TCP/IPコネクション属性設定を終了し，TCP/IP通信サービス環境設定画面に戻ります。

TCP/IPコネクション属性設定画面で設定する項目を次の表に示します。

表2‒7　TCP/IPコネクション属性設定画面で設定する項目

項目名

指定値

対応する定義

コネクション名

〈1〜8文字の識別子〉

mcftalccn -c

【ctcpnn】（nn：整数）

論理端末名

〈1〜8文字の識別子〉

mcftalcle -l

【leidnn】（nn：整数）

アプリケーション名

〈1〜8文字の識別子〉

mcftalcle -v

確立モード

サーバ｜クライアント

（オプションボタンで選択）

mcftalccn -y

コネクションの自動確立

する｜しない

（オプションボタンで選択）

mcftalccn -i

コネクションリプレースの使用

する｜しない

（オプションボタンで選択）

mcftalccn -h chgconn

ポート番号（自システム）

ポート番号｜任意のポート番号

（オプションボタンで選択）

mcftalccn -r portno

（ポート番号を選択した場合）

〈整数〉((1024〜65535))【10001】

ホスト名称

〈255文字以内のホスト名〉

mcftalccn -o hostname

IPアドレス

〈整数〉((0〜255))

mcftalccn -o oipaddr

【nnn.nnn.nnn.nnn】（nnn：整数）

ポート番号（相手システム）

ポート番号｜ポート番号free

（オプションボタンで選択）

mcftalccn -o oportno

（ポート番号を選択した場合）

〈整数〉((1〜65535))【20001】

(f)　環境設定終了時の表示画面

MCF環境設定を終了する場合は，開始画面の［終了（C）］ボタンをクリックします。定義内容変更確認メッセージボックスが表示されます。

定義内容を変更する場合は［はい（Y）］ボタンを，変更しない場合は，［いいえ（N）］ボタンをクリックします。また，環境設定の終了を取りやめて開始画面に戻る場合は，［キャンセル］ボタンをクリックします。

［はい（Y）］ボタンをクリックし，環境設定の内容に変更があった場合だけ，次の定義オブジェクト作成中を示す画面が表示されます。

定義オブジェクトの作成が終了した場合，または環境設定の内容に変更がない場合は，次に示す環境設定終了メッセージボックスが表示されます。［OK］ボタンをクリックすると，環境設定がすべて終了します。

(g)　バージョン情報の表示

環境設定時，メニューバーの［ファイル（F）］メニューから［バージョン情報］を選択すると，バージョン情報画面が表示されます。この画面には，次の情報が表示されます。

TP1/Messagingのバージョンおよびリビジョン

コピーライト

ライセンス登録名（OpenTP1管理者の名前および会社名）

表示内容を確認し，［OK］ボタンをクリックすると，バージョン情報表示画面が終了し，環境設定画面に戻ります。

(h)　生成されるファイル

GUIの画面からMCF環境設定をすると，設定内容に基づいて定義テキストファイルが生成されます。このファイルは，次回にGUIでMCF環境設定をするときの，入力ファイルとなります。それぞれの設定画面には，定義テキストファイルの設定内容が，初期値として仮定されます。

MCF環境設定で生成される定義テキストファイルの一覧を次の表に示します。

表2‒8　MCF環境設定で生成される定義テキストファイル一覧

定義種別

定義ソースファイルパス名

（TEXTPATH=%DCCONFPATH%¥mcfconf¥text）

マネジャ定義

TEXTPATH¥mng¥mcfmngr

アプリケーション定義

TEXTPATH¥apl¥アプリケーショングループ名

アプリケーション間通信サービス定義

通信構成定義共通部

TEXTPATH¥psv¥ccm¥アプリケーション間通信サービス名※

アプリケーション起動環境定義

TEXTPATH¥psv¥cpr¥アプリケーション間通信サービス名※

TCP/IP通信サービス定義

通信構成定義共通部

TEXTPATH¥tcp¥ccm¥TCP/IP通信サービス名※

TCP/IP定義

TEXTPATH¥tcp¥cpr¥TCP/IP通信サービス名※

注※

MCF環境設定GUIで指定した各通信サービス名称の先頭'_'を削除した名称となります。

生成された定義テキストファイルはTP1/Messagingが提供する定義変換コマンドによって，定義オブジェクトファイルに変換されます。定義変換コマンドの詳細については，マニュアル「OpenTP1 システム定義」を参照してください。

MCF環境設定で生成される定義オブジェクトファイルの一覧を次の表に示します。

表2‒9　MCF環境設定で生成される定義オブジェクトファイル一覧

定義種別

定義変換コマンド名

定義オブジェクトファイルパス名

（OBJPATH=%DCCONFPATH%¥mcfconf¥obj）

マネジャ定義

mcfmngr

OBJPATH¥mng¥_mumngr

アプリケーション定義

mcfapli

OBJPATH¥apl¥アプリケーショングループ名

アプリケーション間通信サービス定義

通信構成定義共通部

mcfcomn

OBJPATH¥psv¥ccm¥アプリケーション間通信サービス名※

アプリケーション起動環境定義

mcfpsv

OBJPATH¥psv¥cpr¥アプリケーション間通信サービス名※

上記の結合後

ファイル

mcflink

OBJPATH¥psv¥アプリケーション間通信サービス名

TCP/IP通信サービス定義

通信構成定義

共通部

mcfcomn

OBJPATH¥tcp¥ccm¥TCP/IP通信サービス名※

TCP/IP定義

mcftcp

OBJPATH¥tcp¥cpr¥TCP/IP通信サービス名※

上記の結合後

ファイル

mcflink

OBJPATH¥tcp¥TCP/IP通信サービス名

注※

MCF環境設定GUIで指定した各通信サービス名称の先頭'_'を削除した名称となります。

定義オブジェクトファイルのうち，次に示す定義オブジェクトファイルについては，%DCCONFPATH%の下にも同じファイルが生成されます。

OBJPATH¥mng¥_mumngr

OBJPATH¥apl¥アプリケーショングループ名

OBJPATH¥psv¥アプリケーション間通信サービス名

OBJPATH¥tcp¥TCP/IP通信サービス名

MCF環境設定GUIによって%DCCONFPATH%下に作成される定義関連ファイルの一覧を次の表に示します。これらのファイルがMCF起動時の入力ファイルとなります。

表2‒10　MCF環境設定時%DCCONFPATH%下に生成されるファイル一覧

定義関連ファイル種別

ファイル名

マネジャ定義オブジェクトファイル

_mumngr

アプリケーション定義オブジェクトファイル

アプリケーショングループ名

アプリケーション間通信サービス定義（結合）オブジェクトファイル

アプリケーション間通信サービス名

TCP/IP通信サービス定義（結合）オブジェクトファイル

TCP/IP通信サービス名

TP1/Messagingでは，%DCCONFPATH%下に作成するマネジャ定義オブジェクトファイル名は，OBJPATH¥mng¥_mumngr固定です。

GUIの画面を使用しないで環境設定する場合も，マネジャ定義オブジェクトファイル名は'_mumngr'としてください。

(2)　MHP環境設定

MHP環境設定時の画面構成を次の図に示します。

図2‒4　MHP環境設定時の画面構成

(a)　MHP管理

アプリケーション管理MHPを起動すると，アプリケーション管理画面にMHPの状態が表示されます。

アプリケーション管理画面に表示されている項目について説明します。

メニューバー

［ファイル（F）］メニュー

このメニューから［終了］を選択すると，MHPの環境設定を終了します。

［ヘルプ（H）］メニュー

このメニューから［バージョン情報］を選択すると，TP1/Messagingのバージョン情報が表示されます。

MHP状態表示部

MHPの状態を一覧で表示します。

表示されるのは，ユーザサーバ状態，ユーザサーバ名，サービスグループ名，および常駐・非常駐の区別です。

［サーバ定義（E）］ボタン

MHPの環境を設定します。

新規に環境を設定する場合は，MHP状態表示部からユーザサーバ名を選択しないで，このボタンをクリックします。クリック後，アプリケーション環境画面が表示されます。

すでに定義されているMHPの設定を変更する場合は，ユーザサーバ名を選択してから，ボタンをクリックしてください。MHP環境設定画面が表示されます。

また，MHPの一覧を表示したい場合は，ユーザサーバ名を選択しないで，ボタンをクリックします。

MHP環境設定画面での操作については，「2.3.1(2)(c)　MHP環境設定」を参照してください。

［終了（C）］ボタン

MHPの環境設定を終了します。

アプリケーション管理画面では，上記以外にもボタンが表示されます。その他のボタンの説明については，「3.3　MHPのオペレーション」を参照してください。

(b)　MHP一覧表示

アプリケーション管理画面の［サーバ定義（E）］ボタンをクリックすると，アプリケーション環境画面に，MHPの一覧が表示されます。

アプリケーション環境画面に表示されている項目について説明します。

MHP一覧表示部

定義されているMHPユーザサーバ名，およびMHP環境設定画面の［コメント］で設定された内容を表示します。MHP環境設定については，「2.3.1(2)(c)　MHP環境設定」を参照してください。

［新規作成（N）］ボタン

MHPユーザサーバの環境設定画面を表示します。新規にMHPの環境を設定する場合は，このボタンをクリックします。

［開く（O）］ボタン

すでに設定されているMHPの環境を表示します。MHP一覧表示部でユーザサーバ名を選択してから，ボタンをクリックすると，MHP環境設定画面が表示されます。MHP環境設定画面については，「2.3.1(2)(c)　MHP環境設定」を参照してください。

［削除（D）］ボタン

すでに設定されているMHPの環境を削除します。MHP一覧表示部でユーザサーバ名を選択してから，ボタンをクリックすると，該当するMHPの環境設定内容が削除されます。

［自動起動設定（A）］ボタン

MHPユーザサーバの自動起動について，属性の表示および設定をします。ボタンをクリックすると，自動起動設定画面が表示されます。自動起動設定画面については，「2.3.1(2)(d)　自動起動設定」を参照してください。

［終了（C）］ボタン

アプリケーション環境画面での設定を終了し，アプリケーション管理画面に戻ります。

(c)　MHP環境設定

アプリケーション環境画面で［新規作成（N）］ボタンをクリックするか，またはユーザサーバ名を選択してから［開く（O）］ボタンまたは［削除（D）］ボタンをクリックすると，MHP環境設定の画面が表示されます。

この画面では，MHP環境の参照，設定，および削除ができます。

MHP環境設定画面に表示されている項目について説明します。

［ユーザサーバ名（U）］テキストボックス

環境を設定したいMHPのユーザサーバ名を表示します。ユーザサーバを変更したい場合は，このテキストボックスに該当するユーザサーバ名を直接入力します。ユーザサーバ名には，英字の大文字と小文字の区別はありません。小文字で指定しても，すべて大文字で管理されます。

［サービスグループ名（G）］テキストボックス

［ユーザサーバ名（U）］テキストボックスに表示されているMHPのサービスグループ名を表示します。サービスグループを変更したい場合は，このテキストボックスに該当するサービスグループ名を直接入力します。

［プログラム名（P）］テキストボックス

［ユーザサーバ名（U）］テキストボックスに表示されているMHPのプログラム名を表示します。プログラムを変更したい場合は，このテキストボックスに該当するプログラム名を直接入力します。

プロセス数欄

［常駐（R）］ボックス，および［非常駐（N）］ボックス

MHPの実行プロセスのうち，常駐プロセスおよび非常駐プロセスの数をそれぞれ表示します。ボタンをクリックして値を表示させるか，またはボックスに直接入力します。

優先順位欄

［プロセス（M）］ボックス，および［スケジュール（H）］ボックス

MHPを実行する場合の，プロセスおよびスケジュールの優先順位をそれぞれ表示します。ボタンをクリックして値を表示させるか，またはボックスに直接入力します。

スケジュール情報欄

［サービス滞留件数（Q）］ボックス

MHPを実行する場合に，常駐プロセスで処理するサービス要求の，スケジュール待ち最大数を表示します。ボタンをクリックして値を表示させるか，またはボックスに直接入力します。サービス滞留件数がここで指定した値を超えると，非常駐プロセスが起動されます。

［トランザクション機能（T）］チェックボックス

MHPで，トランザクション機能を使用するかどうかを表示します。使用する場合は，ボックスにチェック（×印）を表示させ，使用しない場合は，空白にします。チェック表示は，ボックスをクリックして行います。

登録するサービス欄

［登録するサービス］リストボックス

MHPに登録されているサービス名と，エントリポイント名の一覧を表示します。

［サービス名（S）］テキストボックス

MHPに登録，またはMHPから削除するサービス名を表示します。サービス名は，キーボードから直接入力してください。

［エントリポイント名（E）］テキストボックス

MHPに登録，またはMHPから削除するエントリポイント名を表示します。エントリポイント名は，キーボードから直接入力してください。

［設定（J）］ボタン

［サービス名（S）］テキストボックスおよび［エントリポイント名（E）］テキストボックス内にある名称を，MHPとして登録します。

［削除（K）］ボタン

［サービス名（S）］テキストボックスおよび［エントリポイント名（E）］テキストボックス内にある名称を，MHPの登録から削除します。

ユーザサーバの環境変数欄

［グローバル］リストボックス

MHPのグローバル環境変数を表示します。

［ローカル］リストボックス

MHPのローカル環境変数を表示します。

［変数（Y）］テキストボックス

MHPの環境変数として設定，または削除する変数名を表示します。変数名は，キーボードから直接入力してください。

［値（Z）］テキストボックス

MHPの環境変数として設定，または削除する変数の値を表示します。値は，キーボードから直接入力してください。

［設定（W）］ボタン

［変数（Y）］テキストボックスおよび［値（Z）］テキストボックス内にある値を，MHPの環境変数として設定します。

［削除（X）］ボタン

［変数（Y）］テキストボックスおよび［値（Z）］テキストボックス内にある値を，MHPの環境変数から削除します。

［初期値設定（I）］ボタン

次に示す項目を初期値（標準値）に戻します。

プロセス数欄

優先順位欄

スケジュール情報欄

［トランザクション機能（T）］チェックボックス

［自動起動設定（A）］ボタン

MHPユーザサーバの自動起動について，属性の表示および設定をします。ボタンをクリックすると，自動起動設定画面が表示されます。自動起動設定画面については，「2.3.1(2)(d)　自動起動設定」を参照してください。

［開く（O）］ボタン

［ユーザサーバ名（U）］テキストボックスに設定されているMHPの環境設定の内容を表示します。

［削除（D）］ボタン

［ユーザサーバ名（U）］テキストボックスに表示されているMHPの環境設定の内容を削除します。

［上書き保存（V）］ボタン

表示されている環境設定内容を，［ユーザサーバ名（U）］テキストボックスに表示されているMHPの環境として保存します。

［終了（C）］ボタン

MHPの環境設定を終了し，この画面を表示する前の画面に戻ります。

このボタンをクリックしたとき，表示されているMHP環境設定の内容が保存されていない場合は，保存確認のダイアログが表示されます。ダイアログ内の［はい（Y）］ボタンをクリックすると，設定内容を保存して終了します。［いいえ（N）］ボタンをクリックすると，設定内容を保存しないで，MHP環境設定画面を表示する前の画面に戻ります。

MHP環境設定画面で設定する項目を次の表に示します。

表2‒11　MHP環境設定画面で設定する項目

項目名

指定値

対応するユーザサービス定義項目

ユーザサーバ名

〈1〜8文字の識別子〉

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

サービスグループ名

〈1〜31文字の識別子〉

service_group

プログラム名

〈1〜14文字の識別子〉

module

プロセス数※

常駐

〈符号なし整数〉((0〜128))【1】

parallel_count

非常駐

〈符号なし整数〉((0〜128))【0】

優先順位

プロセス

〈符号なし整数〉((0〜39))【0】

nice

スケジュール

〈符号なし整数〉((1〜16))【8】

schedule_priority

スケジュール情報

サービス滞留件数

〈符号なし整数〉((0〜512))【3】

balance_count

トランザクション機能

【オフ】

atomic_update

登録するサービス

サービス名エントリポイント名

〈1〜31文字の識別子〉

service

ユーザサーバの環境変数

ローカル変数値

〈1〜63文字の英数字〉

環境変数名

環境変数値

グローバル変数値

〈1〜63文字の英数字〉

ユーザサービスデフォルト定義の環境変数名

ユーザサービスデフォルト定義の環境変数値

注※

MHPの環境設定で定義したMHPプロセスの数を，TP1/LiNKのシステム環境設定画面の［サーバ数］欄内の［SPP（P）］欄で設定するSPPプロセス数に加えてください。

(d)　自動起動設定

アプリケーション環境画面，またはMHP環境設定画面で，［自動起動設定］ボタンをクリックすると，自動起動設定画面が表示されます。この画面では，あらかじめ環境設定されているMHPユーザサーバについて，属性の表示，および自動起動順位の設定をします。

自動起動設定画面に表示されている項目について説明します。

［自動起動あり］リストボックス

自動起動するMHPユーザサーバ名を一覧で表示します。

リストボックスは，優先順位別に，1番目から5番目までに分かれています。これらのボックスは，TP1/LiNK起動時に，該当するMHPユーザサーバが，ユーザサーバ内で何番目に自動起動されるかを示します。表示内容を次に示します。

1番目：優先順位1番で起動されるMHPユーザサーバ名

2番目：優先順位2番で起動されるMHPユーザサーバ名

3番目：優先順位3番で起動されるMHPユーザサーバ名

4番目：優先順位4番で起動されるMHPユーザサーバ名

5番目：優先順位5番で起動されるMHPユーザサーバ名

［自動起動なし］リストボックス

TP1/LiNK起動時に自動起動しないMHPユーザサーバ名を一覧で表示します。

MHPユーザサーバの自動起動の属性，または自動起動の優先順位を変更する場合は，該当するMHPユーザサーバ名をドラッグし，変更したい属性のリストボックスへドロップしてください。移動したMHPユーザサーバ名の属性または優先順位は，自動的に変更されます。

［上書き保存（V）］ボタン

自動起動設定画面に表示されている設定内容を保存します。

［終了（C）］ボタン

自動起動設定を終了し，この画面を表示する前の画面に戻ります。

(e)　バージョン情報の表示

環境設定時，メニューバーの［ファイル（F）］メニューから［バージョン情報］を選択すると，バージョン情報画面が表示されます。

表示内容の詳細については，「2.3.1(1)(g)　バージョン情報の表示」を参照してください。

(f)　生成されるファイル

ユーザサービス定義テキストファイル

GUIの画面からMHP環境設定を行うと，設定内容に基づいて%DCCONFPATH%に定義テキストファイルが作成されます。また，これらの定義テキストファイルは，次回に環境設定GUIを起動したときの入力ファイルになるため，定義テキストファイルの設定内容が，MHP環境設定のGUI画面の初期値として仮定されます。

MHPユーザサーバ用スタブソースファイル

GUIの画面からMHP環境設定を行うと，設定内容に基づいて，MHPユーザサーバ別にスタブソースファイルが生成されます。スタブソースファイルは，%DCDIR%¥APLIBディレクトリに，×××_sstb.cという名称で生成されます。×××はMHPユーザサーバ名を示します。

MHP用のアプリケーションの実行形式ファイル名を作成する場合は，上記のスタブソースファイルをC言語のコンパイラでコンパイルし，MHP用のアプリケーションのオブジェクトファイルとリンケージさせてください。

ユーザサービス構成定義テキストファイル

MHP環境設定の自動起動設定画面から自動起動設定を行うと，設定内容に基づいて%DCCONFPATH%にあるユーザサービス構成定義テキストファイル（usrconf）が更新されます。

ユーザサービスデフォルト定義テキストファイル

MHP環境設定のMHP環境設定画面からグローバル変数の設定を行うと，設定内容に基づいて%DCCONFPATH%にあるユーザサービスデフォルト定義テキストファイル（usrrc）が更新されます。

2.3.2　定義ソースファイル編集による環境設定

TP1/Messagingでは，GUIを使用しないで環境設定ができます。GUIを使用しない場合は，テキストエディタで定義ソースファイルを直接編集します。テキストエディタで編集できる定義ソースファイルの一覧を表2-12および表2-13に示します。

表2‒12　GUIが生成する定義ソースファイル一覧

定義種別

定義ソースファイル

定義生成先ディレクトリ

定義格納ディレクトリ

編集方法

MCF環境設定GUIが生成する定義ソースファイル

マネジャ定義

表2-8参照

%DCCONFPATH%※

◎

アプリケーション定義

表2-8参照

%DCCONFPATH%※

◎

アプリケーション間通信サービス定義

通信構成定義共通部

表2-8参照

%DCCONFPATH%※

◎

アプリケーション起動環境定義

表2-8参照

%DCCONFPATH%※

◎

TCP/IP通信サービス定義

通信構成定義共通部

表2-8参照

%DCCONFPATH%※

◎

TCP/IP定義

表2-8参照

%DCCONFPATH%※

◎

MHP環境設定GUIが生成する定義ソースファイル

ユーザサービス定義

%DCCONFPATH%

○

（凡例）

◎：GUIが生成した定義ソースファイルを編集するか，またはユーザが作成した定義ソースファイルを編集してください。

○：GUIが生成した定義ソースファイルを編集してください。

注※

編集後の定義ソースファイルから作成した定義オブジェクトファイルをこのディレクトリに格納してください。

表2‒13　GUIが生成しない定義ソースファイル一覧

定義種別

定義ソースファイル

定義格納ディレクトリ

インストールされる定義ソースファイル

システムサービス共通情報定義

%DCDIR%¥lib¥sysconf※

ユーザが作成する定義ソースファイル

MCF性能検証用トレース定義

%DCCONFPATH%

リアルタイム取得項目定義

%DCCONFPATH%

注※

このディレクトリの定義ソースファイルを編集してください。

＜MCF環境設定GUIが生成する定義ソースファイルについて＞

マネジャ定義，アプリケーション定義，アプリケーション間通信サービス定義，およびTCP/IP通信サービス定義は，GUIの画面からMCF環境設定をした場合，定義生成先ディレクトリに自動的に生成されます。これらのファイルは，直接，またはファイルコピー後に変更できます。

ただし，GUIが生成した定義ソースファイルをテキストエディタで直接編集した場合は，それ以降のMCF環境設定は，GUIからは行えません。定義ソースファイル編集によって行ってください。また，アプリケーション定義ソースファイルをテキストエディタで直接編集すると，アプリケーション管理画面の内容が不正になるおそれがあります。

＜MHP環境設定GUIが生成する定義ソースファイルについて＞

ユーザサービス定義は，GUIの画面からMHP環境設定をした場合，定義生成先ディレクトリに自動的に生成されます。このファイルは，直接またはファイルコピー後に変更できます。

ただし，GUIが生成した定義ソースファイルをテキストエディタで直接編集した場合は，それ以降のMHP環境設定は，GUIからはできません。定義ソースファイル編集によって行ってください。

注意事項

テキストエディタでユーザサービス定義を直接編集する場合の注意

MHPでサービス関数動的ローディング機能を使用する場合だけにしてください。UAP共用ライブラリ名の指定方法については，マニュアル「TP1/LiNK使用の手引」を参照してください。

GUIが生成したユーザサービス定義を編集してください。そうでない場合は，MHPユーザサーバを起動できなくなるおそれがあります。

編集可能な項目は表2-11（ユーザサーバ名は除きます）および表2-21で示している項目だけです。

エントリポイント名を変更した場合は，変更後のエントリポイント名に対応するスタブソースファイルを作成してください。スタブソースファイルの作成方法については，マニュアル「OpenTP1 使用の手引 Windows(R)編」を参照してください。

＜GUIが生成しない定義ソースファイルについて＞

システムサービス共通情報定義は，TP1/Messagingのインストール時に定義格納ディレクトリに配置されます。これらのファイルは，直接，変更できます。MCF性能検証用トレース定義およびリアルタイム取得項目定義は，ユーザが作成してください。

TP1/Messagingで設定できる定義項目の一覧を，表2-14〜表2-18および表2-21〜表2-24に示します。ここに示す値は，GUIの画面に設定される値と異なります。また，TP1/Messagingの定義変換コマンドの一覧を表2-19に，定義オブジェクトファイルの一覧を表2-20に示します。

なお，環境設定の各定義ソースファイルの作成方法の詳細については，マニュアル「OpenTP1 システム定義」，および「OpenTP1 プロトコル TP1/NET/TCP/IP編」を参照してください。

表2‒14　定義設定項目一覧（MCFマネジャ定義）

定義コマンド

オプション

オペランド

定義内容

指定値

MCF環境定義

mcfmenv

-m

name

MCFサービス(マネジャ)名

〈1〜8文字の識別子〉

MCF共通定義

mcfmcomn

-n

−

通番を使用する論理端末数

((0〜2048))《0》

-p

−

MCF作業領域長※1

((100〜2000000))

MCF通信サービス定義

mcfmcname

指定数：1〜239

-s

mcfsvname

MCF通信サービス名

〈1〜8文字の英数字〉

syssvname

システムサービス情報定義ファイル名※2

〈1〜8文字の識別子〉

UAP共通定義

mcfmuap

-d

−

MHPがトランザクション処理中に発行する通信関数の発行回数の上限値

((0〜65535))《0》

-t

sndtim

同期型送信監視時間

((0〜65535))《0》

（単位：秒）

sndrcvtim

同期型送受信監視時間

((0〜65535))《0》

（単位：秒）

recvtim

同期型受信監視時間

((0〜65535))《0》

（単位：秒）

-e

segsize

エラーイベント処理用MHP起動時，またはアプリケーション起動機能使用時の最大セグメント長

((512〜2147483647))

《512》

-l

initseq

通番の初期値

((0〜2147483647))

《1》

maxseq

ラップ時の通番の最大値

((0〜2147483647))

《65535》

minseq

ラップ後の通番の開始値

((0〜1))《1》

-u

ntmetim

非トランザクションMHP限界経過時間

((0〜65535))《0》

（単位：秒）

-a

delaytim

アプリケーション起動時の遅延許容時間

((0〜360))《0》

（単位：分）

-c

order

メッセージ送信順序および再送順序ならびにアプリケーション起動順序の選択

function｜《commit》

noansreply※3

非応答型のMHPからの問い合わせ応答をするかどうかを指定

yes｜《no》

otqinhold

出力キューの入力保留中の動作を指定

《commit》｜function

-r

reschedulecnt※3

アプリケーション異常終了時の再スケジュール回数

〈符号なし整数〉

((0〜3))《0》

（単位：回）

rescheduleint※3

アプリケーション異常終了時の再スケジュール間隔

〈符号なし整数〉

((0〜3))《0》

（単位：秒）

reschedulelog※3

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

yes｜《no》

ログメッセージ出力抑止定義

mcfmsmsg

-m※3

−

ログファイルへの出力を抑止するメッセージID

〈符号なし整数〉

((10000〜19999，28000〜29999))

サービスグループ属性定義

mcfmsvg

指定数：0〜8192

-g

servgrpn※3

サービスグループ名

〈1〜31文字の識別子〉

-w

watchcnt※3

入力キューの滞留監視数

〈符号なし整数〉

((0〜65535))《0》

watchint※3

入力キューの滞留監視インタバル時間

〈符号なし整数〉

((5〜3600))《10》

（単位：秒）

expectcnt※3

MHPに期待するサービス要求の処理数

〈符号なし整数〉

((1〜65535))

abort※3

MHPの処理能力不足時のOpenTP1システムのダウン可否

yes｜《no》

（凡例）

−：該当する項目はありません。

注※1

資源自動見積もり機能で共用メモリ所要量を算出しますので，-pオプションの指定値は無視しますが，指定値の欄に示す値を指定しておく必要があります。

注※2

TP1/Messagingでは，システムサービス情報定義は自動的にインストールされます。syssvnameオペランドには，次の名称を指定してください。

・TCP/IP通信サービスの場合：mcfutcpd

・アプリケーション間通信サービスの場合：mcfupsvd

注※3

このオプションまたはオペランドを指定する場合，TP1/Messaging - Extension 1が必要です。

表2‒15　定義設定項目一覧（MCFアプリケーション定義共通部）

定義コマンド

オプション

オペランド

定義内容

指定値

アプリケーション環境定義

mcfaenv

-a

−

MCFアプリケーション定義識別子

〈1〜8文字の識別子〉

-p

−

アプリケーション起動プロセス識別子

ef

アプリケーション属性定義

mcfaalcap

指定数：1〜64または1〜8192※4

-n

name

アプリケーション名

〈1〜8文字の識別子〉

kind

アプリケーション種別

《user》｜mcf

type

アプリケーションの型

ans※5｜《noans》

aplihold

アプリケーション異常終了時のアプリケーションの処置

《m》｜a｜s

msgcnt

入力メッセージの最大格納数

((0〜65535))《0》

lname

アプリケーション起動機能使用時の内部通信路上の論理端末名称

〈1〜8文字の識別子〉

cname

アプリケーション起動機能使用時の内部通信路名

〈1〜8文字の識別子〉

trnmode

アプリケーションのトランザクション属性

《trn》｜nontrn

errevt※6

通信イベント障害時のエラーイベントを通知するかどうかを指定

yes｜《no》

replychk※6

応答送信チェックをするかどうかを指定

《yes》｜no

-N

modelname※6

モデルアプリケーション名，またはモデルMCFイベント名

〈1〜8文字の識別子〉

-g

servgrpn

アプリケーションのサービスグループ名

〈1〜31文字の識別子〉

srgvhold

アプリケーション異常終了時のサービスグループの処置

《m》｜s

-v

servname

アプリケーション名に対応するサービス名

〈1〜31文字の識別子〉

servhold

アプリケーション異常終了時のサービスの処置

《m》｜a｜s

ntmetim

非トランザクションMHP限界経過時間※1

((0〜65535))

（単位：秒）

-d

holdlimit

アプリケーション異常終了時限界回数※2

((1〜65535))《1》

holdmtyp

アプリケーション異常終了回数カウント方法※3

sum｜《cont》

reschedulecnt※6

アプリケーション異常終了時の再スケジュール回数

〈符号なし整数〉

((0〜3))

（単位：回）

rescheduleint※6

アプリケーション異常終了時の再スケジュール間隔

〈符号なし整数〉

((0〜3))

（単位：秒）

reschedulelog※6

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

yes｜no

-e

evtlogout※6

ERREVT1〜ERREVT4を起動するとき，ログメッセージを出力するかどうかを指定

yes｜《no》

（凡例）

−：該当する項目はありません。

注※1

アプリケーション属性定義の-n trnmodeでnontrnを指定した場合だけ有効です。

注※2

アプリケーション属性定義の-n aplihold，または-v servholdのどちらかでaを指定した場合だけ有効です。

注※3

アプリケーション属性定義の-d holdlimitに対応しています。

注※4

TP1/Messaging - Extension 1をインストールしていない場合：1〜64

TP1/Messaging - Extension 1をインストールしている場合：1〜8192

注※5

typeオペランドにansを指定する場合，TP1/Messaging - Extension 1が必要です。

注※6

このオペランドを指定する場合，TP1/Messaging - Extension 1が必要です。

表2‒16　定義設定項目一覧（MCF通信構成定義共通部）

定義コマンド

オプション

オペランド

定義内容

指定値

MCF環境定義

mcftenv

-s

−

MCF通信プロセス識別子，またはアプリケーション起動プロセス識別子

((01〜ee))

（アプリケーション起動プロセス識別子の場合：ef）

-a

−

MCFアプリケーション定義オブジェクトファイル名

〈1〜8文字の識別子〉

MCF通信構成共通定義

mcftcomn

−

−

−

−

最大処理多重度定義

mcfttred

-m

−

最大処理多重度

（並行処理メッセージ数）

((1〜10))《10》

タイマ定義

mcfttim

-t

btim

時間監視間隔

((1〜60))《1》

（単位：秒）

mtim

未処理送信メッセージ滞留時間

((60〜65535))《180》

（単位：秒）

rmtim

未処理受信メッセージ滞留時間

((0〜65535))《0》

（単位：秒）

-p

usertime

ユーザタイマ監視機能を使用するかどうかを指定

yes｜《no》

timereqno

最大タイマ監視要求数

〈符号なし整数〉

((1〜10000))《16》

msgsize

最大メッセージ長

〈符号なし整数〉

((0〜256))《0》

（単位：バイト）

msgout

メッセージを出力するかどうかを指定

yes｜《no》

トレース環境定義

mcfttrc

-t

size

MCFトレースバッファの大きさ

((4096〜15728640の4の倍数))《204800》

disk

MCFトレースのディスク出力機能を使用するかどうかを指定

《yes》｜no

bufcnt

MCFトレースバッファの数

((10〜2147483647))

《100》

trccnt

MCFトレースファイルの数

（3〜99）《3》

msgsize

トレースとして取得する送受信メッセージの最大サイズ

((0〜1073741824))《128》

（単位：バイト）

-m

−

MCFトレースファイルの数を超えたときの処置

《del》｜off

バッファグループ定義

mcftbuf

指定数：0または1〜512※2

-g

groupno

メッセージ送受信用およびメッセージ編集用バッファグループ番号

((1〜512))

length

メッセージ送受信用およびメッセージ編集用バッファ長

((512〜1073741824))

（単位：バイト）

count

メッセージ送受信用およびメッセージ編集用バッファ数

((1〜65535))

（凡例）

−：該当する項目はありません。

注※1

このオプションを指定する場合，TP1/Messaging - Extension 1が必要です。

注※2

アプリケーション起動プロセスの場合：0

MCF通信プロセスの場合：1〜512

表2‒17　定義設定項目一覧（アプリケーション起動環境定義）

定義コマンド

オプション

オペランド

定義内容

指定値

アプリケーション起動環境定義

mcftpsvr

-c

−

内部通信路名

〈1〜8文字の識別子〉

論理端末定義

mcftalcle

-l

−

論理端末名称

〈1〜8文字の識別子〉

-t

−

この論理端末の端末タイプ

send｜request※

アプリケーション起動環境定義の終了

mcftped

−

−

アプリケーション起動環境定義の終了

−

（凡例）

−：該当する項目はありません。

注※

-tオプションにrequestを指定する場合，TP1/Messaging - Extension 1が必要です。

表2‒18　定義設定項目一覧（MCF通信構成定義TCP/IP固有部）

定義コマンド

オプション

オペランド

定義内容

指定値

コネクション定義の開始

mcftalccn

指定数：1〜16または1〜300※¹

-c

−

コネクションID

〈1〜8文字の識別子〉

-N

modelname※²

モデルコネクションID

〈1〜8文字の識別子〉

-p

−

プロトコルの種別

〈tcp〉

-g

sndbuf

メッセージ送信用バッファグループ番号

((1〜512))

rcvbuf

メッセージ受信用バッファグループ番号

((1〜512))

-i

−

システム開始時および再開始時にコネクションを自動的に確立するかどうか

auto｜《manual》

-b

bretry

コネクション確立時に障害が発生した場合にコネクション確立再試行をするかどうか

《yes》｜no

bretrycnt

コネクション確立再試行回数

((0〜65535))《0》

【10】※3

bretryint

コネクション確立再試行の時間間隔

((0〜2550))《60》

（単位：秒）

-w

srtimout

コネクション切断抑止をするかどうかを指定

yes｜《no》

-t

−

トランスポート層のプロトコルの種別

tcp

-y

mode

クライアントとサーバの種別

client｜server

-r

portno

自システムのポート番号

((1024〜65535))《0》

-o

ohostname

相手システムのホスト名

〈1〜255文字のホスト名〉

oipaddr

相手システムのホストのIPアドレス

〈符号なし整数〉

((0〜255))

（nnn.nnn.nnn.nnn）

oportno

相手システムのホストのポート番号

((1〜65535))〈free〉

-k

keepalive

キープアライブ

yes｜《no》

nodelay※²

ソケットオプション「TCP_NODELAY」を使用するかどうかを指定

yes｜《no》

notrftime※²

無通信状態監視時間

符号なし整数

((0〜65535))《0》

（単位：秒）

-f

kind

相手局からのコネクション解放の通知

《ccls》｜cerr

cnrelease※²

コネクション解放形態

《fin》｜rst

releaselog

コネクション解放時のログメッセージの形式

1｜《2》

cnerrlog

障害によるコネクション切断時のログメッセージの形式

1｜《2》

-A

mastercn※4

現用コネクションID

〈1〜8文字の識別子〉

-u

masm

受信メッセージ組み立て機能の使用※⁵

《yes》｜no

ntimer

後続セグメント受信の監視タイマ

《yes》｜no

ntime

後続セグメント受信の監視タイマ値

((1〜2550))《30》

（単位：秒）

delichk※²

メッセージ送達確認機能を使用するかどうかを指定

dccm2m｜dccm2s｜dccm3m｜dccm3s｜《nouse》

-h

addrchk※²

相手アドレス情報のチェックをするかどうかを指定

《yes》｜no※⁶

chgconn

コネクションリプレース使用の有無

replace｜《keep》

listen※²

オンライン開始時から自動的にコネクション確立要求を受け付けるかどうかを指定

《auto》｜manual

-l

replymsg※²

問い合わせ応答形態および継続問い合わせ応答形態のメッセージ送受信を行うかどうかを指定

yes｜《no》

cnassign※²

相手からのコネクション確立要求時にコネクションを割り当てる対象の選択

《freeonly》｜all

論理端末定義

mcftalcle

指定数：1〜16または1〜300※¹

-l

−

論理端末名称

〈1〜8文字の識別子〉

-N

modelname※²

モデル論理端末名称

〈1〜8文字の識別子〉

-t

−

論理端末の端末タイプ

any

-i

−

論理端末の起動方法

《auto》｜manual

-v

−

アプリケーション名

〈1〜8文字の識別子〉

-d

replacemsg※²

コネクション再確立時に未送信メッセージを送信するかどうかを指定（コネクション再確立時の未送信メッセージの送信抑止機能を使用するかどうかを指定）

《send》｜discard

コネクション定義の終了

mcftalced

指定数：mcftalccnと同数

−

−

コネクション定義の終了

−

（凡例）

−：該当する項目はありません。

注※1

TP1/Messaging - Extension 1をインストールしていない場合：1〜16

TP1/Messaging - Extension 1をインストールしている場合：1〜300

注※2

このオペランドを指定する場合，TP1/Messaging - Extension 1が必要です。

注※3

GUIによって生成される定義には自動的に10が設定されます。

注※4

このオペランドを指定する場合，TP1/NET/High Availabilityが必要です。

注※5

TP1/MessagingではUOC機能をサポートしません。

注※6

TP1/Messagingではコネクション確立UOCをサポートしないため，addrchkオペランドにnoを指定した場合，未確立コネクションがあれば必ずコネクション確立要求を受け入れます。必要に応じて，ネットワーク機器などによるアクセス制限を検討してください。

表2‒19　定義変換コマンド一覧

定義種別

定義変換コマンド名

MCFマネジャ定義

mcfmngr

MCFアプリケーション定義

mcfapli

アプリケーション間通信サービス定義

通信構成定義共通部

mcfcomn

アプリケーション起動環境定義

mcfpsvr

結合

mcflink

TCP/IP通信サービス定義

通信構成定義共通部

mcfcomn

TCP/IPプロトコル定義

mcftcp

結合

mcflink

表2‒20　定義オブジェクトファイル一覧

定義オブジェクトファイル種別

定義オブジェクトファイル名

マネジャ定義オブジェクトファイル※

_mumngr

アプリケーション定義オブジェクトファイル

1〜8文字の識別子

アプリケーション間通信サービス定義オブジェクトファイル

_muで始まる1〜8文字の識別子

TCP/IP通信サービス定義オブジェクトファイル

_muで始まる1〜8文字の識別子

注※

TP1/Messagingでは，マネジャ定義オブジェクトファイル名は必ず'_mumngr'としてください。異なる名称を指定した場合，TP1/LiNK起動後に引き続いてTP1/Messagingが自動起動されません。

表2‒21　定義設定項目一覧（ユーザサービス定義）

形式

オペランド

定義内容

指定値

set

service

UAP共用ライブラリ名※

〈1〜255文字のパス名〉

注※

この定義内容を指定する場合，TP1/Messaging - Extension 1が必要です。

表2‒22　定義設定項目一覧（システムサービス共通情報定義）

形式

オペランド

定義内容

指定値

set

max_socket_descriptors※

ソケット用ファイル記述子の最大数

〈符号なし整数〉

((64〜3596))

max_open_fds※

MCF通信プロセスでアクセスするファイルの最大数

〈符号なし整数〉

((100〜4032))

mcf_prf_trace_level

MCF性能検証用トレース情報の取得レベル

((00000000〜00000001))

《00000001》

mcf_start_watch_interval※

MCF開始時プロセス間監視時間間隔

〈符号なし整数〉

((10〜3000))《3000》

（単位：ミリ秒）

注※

このオペランドを指定する場合，TP1/Messaging - Extension 1が必要です。

表2‒23　定義設定項目一覧（MCF性能検証用トレース定義）

形式

オペランド

定義内容

指定値

set

prf_file_size

MCF性能検証用トレース情報ファイルのサイズ

〈符号なし整数〉

((1024〜1048576))《1024》

（単位：キロバイト）

prf_file_count

MCF性能検証用トレース情報ファイルの世代数

〈符号なし整数〉

((3〜256))《3》

表2‒24　定義設定項目一覧（リアルタイム取得項目定義）

形式

オペランド

定義内容

指定値

set

rts_mcf_ap_scd_stay※

スケジュール待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_ap_usr_srvc※

ユーザサービス実行情報を取得するかどうかを指定

Y｜《N》

rts_mcf_in_msg_scd_wait※

論理端末単位に受信メッセージの処理待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_out_msg_sync_scd_wait※

同期型送信メッセージの処理待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_out_msg_resp_scd_wait※

問い合わせ応答型送信メッセージの処理待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_out_msg_prio_scd_wait※

優先分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_out_msg_norm_scd_wait※

一般分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

Y｜《N》

rts_mcf_que_scd_wait_num※

入力キューの滞留数の情報を取得するかどうかを指定

Y｜《N》

注※

このオペランドにYを指定する場合，TP1/Messaging - Extension 1が必要です。

2.3.3　共用メモリ算出用定義ソースファイルの編集による環境設定

TP1/Messagingは，各論理端末のキューに滞留する平均メッセージ数を基に，各通信サービスの共用メモリ所要量を自動計算し，起動時に一括確保します。

平均メッセージ数に基づく値は共用メモリ算出用定義ソースファイル（%DCDIR%¥lib¥sysconf¥mcfesti）のotqqnumオペランドおよびitqqnumオペランドに記述され，各オペランドには事前に1が設定されています。

ユーザはシステム構成および業務運用形態に応じて，otqqnumオペランドおよびitqqnumオペランドの値を変更できます。変更した場合，共用メモリ所要量が変動するので注意してください。また，他オペランドの設定値を変更しないでください。

共用メモリ算出用定義項目一覧を次の表に示します。

表2‒25　共用メモリ算出用定義項目一覧

オペランド

定義内容

共用メモリ所要量の計算式

（単位：バイト）

指定値

otqqnum

各出力先論理端末の出力キューに滞留する平均メッセージ数

動的共用メモリ：

otqqnum指定値

×論理端末数

×TCP/IP通信サービス環境設定のユーザメッセージ長の指定値（アプリケーション間通信サービスの場合は32000）

×安全値（1.1）

((1〜256))

静的共用メモリ：

otqqnum指定値

×論理端末数

×768

×安全値（1.1）

itqqnum

各論理端末の入力キューに滞留する平均メッセージ数

動的共用メモリ：

itqqnum指定値

×論理端末数

×TCP/IP通信サービス環境設定のユーザメッセージ長の指定値（アプリケーション間通信サービスの場合は32000）

×安全値（1.1）

((1〜256))

静的共用メモリ：

0

3　オペレーション

この章では，TP1/Messagingのオペレーション（運用時の操作）について説明します。

3.1　TP1/Messagingの起動と停止

TP1/Messagingは，TP1/LiNKを起動，および停止するときに，同じタイミングで自動的に起動，および停止します。

TP1/Messagingを起動するときは，TP1/LiNKを起動します。

TP1/LiNKを起動するには，画面に表示されているアイコンの中からTP1/LiNKコントロールアイコンをダブルクリックし，TP1/LiNKコントロール画面を表示します。次に，TP1/LiNKコントロール画面内の［起動（S）］ボタンをクリックし，TP1/LiNKを起動します。

TP1/Messagingを停止するときは，TP1/LiNKを停止，または強制停止させます。TP1/Messagingを正常に停止する場合は，TP1/LiNKを停止してください。このとき，TP1/Messagingの終了モードは，計画停止Aとなります。

また，業務の都合によって，TP1/Messagingを強制的に停止させる場合は，TP1/LiNKを強制停止してください。このときのTP1/Messagingの終了モードは，強制停止となります。

TP1/LiNKを停止，または強制停止するには，起動時と同様にTP1/LiNKコントロールアイコンをダブルクリックし，TP1/LiNKコントロール画面を表示します。次に，TP1/LiNKコントロール画面内の［停止（T）］ボタン，または［強制停止（O）］ボタンをクリックし，TP1/LiNKを停止，または強制停止します。

TP1/LiNKの起動，停止，および強制停止の詳細については，マニュアル「TP1/LiNK 使用の手引」を参照してください。

3.2　MCFのオペレーション

3.2.1　GUIの画面からのオペレーション（MCF）

MCFのオペレーションは，必ずTP1/LiNKおよびTP1/Messagingの起動中に行います。

MCFオペレーション時の画面構成を次の図に示します。

図3‒1　MCFオペレーション時の画面構成

MCFオペレーションを起動すると，オペレーション画面が表示されます。

画面に表示されている項目について説明します。

［コネクション・論理端末（C）］ボタン

コネクションおよび論理端末の画面を表示します。

詳細については，「3.2.1(1)　コネクションおよび論理端末の管理」を参照してください。

［アプリケーション（A）］ボタン

アプリケーションの画面を表示します。

詳細については，「3.2.1(2)　アプリケーションの管理」を参照してください。

メニューバー

［ファイル（F）］メニュー

このメニューから，［終了（X）］をクリックすると，MCFまたはMHPのオペレーションを終了します。

［ヘルプ（H）］メニュー

このメニューから，［バージョン情報］をクリックすると，バージョン情報が表示されます。詳細については，「3.2.1(3)　バージョン情報の表示」を参照してください。

(1)　コネクションおよび論理端末の管理

MCFオペレーション画面で［コネクション・論理端末（C）］ボタンをクリックすると，コネクションおよび論理端末の画面が表示されます。この画面では，TP1/Messagingで環境設定されている通信サービスのコネクション，および論理端末について，情報および状態を一覧で表示します。

画面に表示されている項目について説明します。

メッセージ出力欄

コネクションおよび論理端末の画面を表示する直前に実行されたオペレーションに対して，メッセージを表示します。表示されるメッセージを次に示します。

コネクション確立要求を行っています…しばらくお待ちください

コネクション解放要求を行っています…しばらくお待ちください

論理端末の閉塞解除要求を行っています…しばらくお待ちください

論理端末の閉塞要求を行っています…しばらくお待ちください

最新のコネクションと論理端末状態を調べています…しばらくお待ちください

年／月／日 時：分：秒 現在のコネクションと論理端末の状態

上記に示すメッセージ以外に，OpenTP1のメッセージがダイアログで表示される場合があります。OpenTP1のメッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

状態表示欄

各コネクション，および論理端末の状態を表示します。

表示内容の詳細については，「3.2.1(1)(e)　コネクションおよび論理端末の状態表示」を参照してください。

識別子

コネクション名に示すコネクションが属する通信サービスのプロセス識別子を表示します。

コネクション名

TP1/Messagingで環境設定されているコネクションの名称を表示します。

コネクション状態

コネクション名に示すコネクションの状態を表示します。表示の詳細については，「3.2.1(1)(e)　コネクションおよび論理端末の状態表示」を参照してください。

論理端末名

コネクション名に示すコネクションに対応する論理端末名を表示します。

論理端末状態

論理端末名に示す論理端末の状態を表示します。

［コネクションの確立（A）］ボタン

コネクションを確立します。

［コネクションの解放（D）］ボタン

コネクションを解放します。

［論理端末の閉塞解除（S）］ボタン

論理端末を閉塞解除します。

［論理端末の閉塞（F）］ボタン

論理端末を閉塞します。

［最新の情報（N）］ボタン

コネクション，およびコネクションに対応する論理端末の最新の情報を表示します。

［終了（E）］ボタン

コネクション，および論理端末のオペレーションを終了します。

上記に示すボタンには，OpenTP1で実行する運用コマンドに対応しているものがあります。それぞれのボタンと運用コマンドとの対応を次の表に示します。

表3‒1　オペレーションボタンと対応する運用コマンド（コネクション・論理端末画面）

オペレーションボタン

実行される運用コマンド

［最新の情報］ボタン

mcftlscn

mcftlsle

［コネクションの確立］ボタン

mcftactcn

［コネクションの解放］ボタン

mcftdctcn

［論理端末の閉塞解除］ボタン

mcftactle

［論理端末の閉塞］ボタン

mcftdctle

［終了］ボタン

−

（凡例）

−：対応するコマンドがないことを示します。

コネクション・論理端末画面から行える操作について説明します。

(a)　コネクションの確立

解放状態のコネクションのコネクション名を状態表示欄から選択し，［コネクションの確立（A）］ボタンをクリックすると，選択したコネクションが確立されます。コネクションは，複数を選択して確立することもできます。

コネクションが確立されると，選択されたコネクションの状態は「確立」になります。

(b)　コネクションの解放

確立状態のコネクションのコネクション名を状態表示欄から選択し，［コネクションの解放（D）］ボタンをクリックすると，選択したコネクションが解放されます。コネクションは，複数を選択して解放することもできます。

コネクションが解放されると，選択されたコネクションの状態は「解放」になります。

(c)　論理端末の閉塞解除

閉塞状態の論理端末の論理端末名を状態表示欄から選択し，［論理端末の閉塞解除（S）］ボタンをクリックすると，選択した論理端末が閉塞解除されます。論理端末は，複数を選択して閉塞解除することもできます。

論理端末が閉塞解除されると，選択された論理端末の状態は「閉塞解除」になります。

(d)　論理端末の閉塞

閉塞解除状態の論理端末の論理端末名を状態表示欄から選択し，［論理端末の閉塞（F）］ボタンをクリックすると，選択した論理端末が閉塞されます。論理端末は，複数を選択して閉塞することもできます。

論理端末が閉塞されると，選択された論理端末の状態は「閉塞」になります。

(e)　コネクションおよび論理端末の状態表示

［最新の情報（N）］ボタンをクリックすると，コネクション，および対応する論理端末の最新の情報が表示されます。

表示されるコネクションの状態を次に示します。

「確立処理中」：該当するコネクションは確立処理中です。

「確立」：該当するコネクションは確立されています。

「解放処理中」：該当するコネクションは解放処理中です。

「解放」：該当するコネクションは解放されています。

また，表示される論理端末の状態は次のとおりです。

「閉塞解除」：該当する論理端末は閉塞解除されています。

「閉塞」：該当する論理端末は閉塞されています。

状態表示されるコネクションおよび論理端末は，TP1/Messagingで環境設定されている通信サービスのコネクション，および論理端末です。なお，一つのコネクションに対して一つの論理端末が対応しています。

(2)　アプリケーションの管理

オペレーション画面で［アプリケーション（A）］ボタンをクリックすると，アプリケーションの画面が表示されます。この画面では，TP1/Messagingで環境設定されている通信サービスに対応するアプリケーションについて，情報および状態を一覧で表示します。

一つのアプリケーションが複数の通信サービスに対応している場合は，同じアプリケーション名が複数表示されます。

アプリケーションは512個まで表示できます。アプリケーションの表示数が多くなると，初回描画時間が大幅に増えるので注意してください。

画面に表示されている項目について説明します。

メッセージ出力欄

アプリケーション画面を表示する直前に実行されたオペレーションに対して，メッセージを表示します。表示されるメッセージを次に示します。

アプリケーションの閉塞解除要求を行っています…しばらくお待ちください

アプリケーションの閉塞要求を行っています…しばらくお待ちください

最新のアプリケーション状態を調べています…しばらくお待ちください

年／月／日 時：分：秒 現在のアプリケーションの状態

プロセス識別子の取得に失敗したため，状態を表示できません

上記に示すメッセージ以外に，OpenTP1のメッセージがダイアログで表示される場合があります。OpenTP1のメッセージの詳細については，マニュアル「OpenTP1 メッセージ」を参照してください。

状態表示欄

アプリケーションの状態を表示します。

表示内容の詳細については，「3.2.1(2)(c)　アプリケーションの状態表示」を参照してください。

識別子

アプリケーション名に示すアプリケーションが属する通信サービスのプロセス識別子を表示します。

アプリケーション名

TP1/Messagingで環境設定されているアプリケーションの名称を表示します。一つの通信サービスに複数のアプリケーションが対応している場合は，同じ識別子を持つアプリケーション名が複数表示されます。

種別

アプリケーション名に示すMCFのアプリケーションの種別を表示します。

「ユーザ」：ユーザのアプリケーションであることを示します。

「MCF」：OpenTP1のMCFイベントであることを示します。

入力状態

アプリケーション名に示すMCFのアプリケーションの入力状態を表示します。

「閉塞解除」：該当するアプリケーションの入力は閉塞解除されています。

「閉塞」：該当するアプリケーションの入力は閉塞されています。

「SPP」：該当するアプリケーションは，SPPのアプリケーションです。

スケジュール状態

アプリケーション名に示すMCFのアプリケーションのスケジュール状態を表示します。

「閉塞解除」：該当するアプリケーションのスケジュールは閉塞解除されています。

「閉塞」：該当するアプリケーションのスケジュールは閉塞されています。

「SPP」：該当するアプリケーションは，SPPのアプリケーションです。

サービスグループ名

アプリケーション名が示すMCFアプリケーションに対応するサービスグループ名を表示します。

サービス名

アプリケーション名が示すMCFアプリケーションに対応するサービス名を表示します。

［閉塞解除（A）］ボタン

アプリケーションを閉塞解除します。

［閉塞（D）］ボタン

アプリケーションを閉塞します。

［最新の状態（N）］ボタン

すべてのアプリケーションの最新の状態を表示します。

［終了（E）］ボタン

アプリケーションのオペレーションを終了します。

上記に示すボタンには，OpenTP1で実行する運用コマンドに対応しているものがあります。それぞれのボタンと運用コマンドとの対応を次の表に示します。

表3‒2　オペレーションボタンと対応する運用コマンド（アプリケーション画面）

オペレーションボタン

実行される運用コマンド

［閉塞解除］ボタン

mcfaactap

［閉塞］ボタン

mcfadctap

［最新の状態］ボタン

mcfalsap

［終了］ボタン

−

（凡例）

−：対応するコマンドがないことを示します。

次に，アプリケーション画面から行える操作について説明します。

(a)　アプリケーションの閉塞解除

入力状態またはスケジュール状態が「閉塞」のアプリケーション名を状態表示欄から選択し，［閉塞解除（A）］ボタンをクリックすると，選択したアプリケーションが閉塞解除されます。アプリケーションは，複数を選択して閉塞解除することもできます。

アプリケーションが正常に閉塞解除されると，選択されたアプリケーションの状態は「閉塞解除」になります。

(b)　アプリケーションの閉塞

入力状態またはスケジュール状態が「閉塞解除」のアプリケーション名を状態表示欄から選択し，［閉塞（D）］ボタンをクリックすると，選択したアプリケーションが閉塞されます。アプリケーションは，複数を選択して閉塞することもできます。

アプリケーションが正常に閉塞されると，選択されたアプリケーションの状態は「閉塞」になります。

(c)　アプリケーションの状態表示

アプリケーション名を状態表示欄から選択し，［最新の状態（N）］ボタンをクリックすると，すべてのアプリケーションの状態が表示されます。

表示されるアプリケーションの状態を次に示します。

「閉塞解除」：該当するアプリケーションは閉塞解除されています。

「閉塞」：該当するアプリケーション閉塞されています。

状態表示されるアプリケーションは，TP1/Messagingで環境設定されている通信サービスのアプリケーションです。なお，一つのコネクションに対して，一つまたは複数の論理端末が対応しています。

(3)　バージョン情報の表示

オペレーション画面のメニューバーで［ファイル（F）］を選択し，［バージョン情報］をクリックすると，バージョン情報画面が表示されます。この画面には，次の情報が表示されます。

TP1/Messagingのバージョンおよびリビジョン

コピーライト

ライセンス登録名（OpenTP1管理者の名前および会社名）

表示内容を確認後，［OK］ボタンをクリックすると，オペレーション画面に戻ります。

(4)　MCFのオペレーションの終了

コネクションおよび論理端末のオペレーション，またはアプリケーションのオペレーションを終了する場合は，それぞれの画面に表示されている［終了（E）］ボタンをクリックします。

MCFのオペレーションをすべて終了する場合は，オペレーション画面のメニューバーから［ファイル（F）］を選択し，［終了（E）］をクリックしてください。

3.2.2　コマンドプロンプト画面からのオペレーション（MCF）

MCFに対するオペレーションは，コマンドプロンプト画面から運用コマンドを実行して行えます。コマンドプロンプトとは，キーボードから文字を直接入力して，コマンドを実行する操作です。コマンドプロンプト画面からのオペレーションをするときは，WindowsのGUIから画面を切り替えます。

注意事項

MCFのオペレーションは，必ずTP1/LiNKおよびTP1/Messagingの起動中に行ってください。

TP1/Messagingで実行できるMCFの運用コマンドを次の表に示します。表に示す運用コマンド，およびその他の運用コマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

表3‒3　TP1/Messagingで実行できるMCFの運用コマンド

運用コマンド名

機能

mcftactcn

コネクションの確立

mcftdctcn

コネクションの解放

mcftlscn

コネクションの状態表示

mcftchcn※1

コネクションの切り替え

mcftlsln※²

ネットワークの状態表示

mcftonln※²

サーバ型コネクションの確立要求の受付開始

mcftofln※²

サーバ型コネクションの確立要求の受付終了

mcftlstrd※²

メッセージ多重処理状況の表示

mcftactle

論理端末の閉塞解除

mcftdctle

論理端末の閉塞

mcftlsle

論理端末の状態表示

mcfthldoq

論理端末の出力キュー処理の保留

mcftrlsoq

論理端末の出力キュー処理の保留解除

mcftdlqle

論理端末の出力キュー削除

mcftspqle

論理端末のメッセージキューの先頭スキップ

mcftactsv

サービスの閉塞解除

mcftdctsv

サービスの閉塞

mcftlssv

サービスの状態表示

mcftlsbuf

バッファグループの使用状況表示

mcftswptr

MCFイベントトレースファイルの強制スワップ

mcfaactap

アプリケーションの閉塞解除

mcfadctap

アプリケーションの閉塞

mcfalsap

アプリケーションの状態表示

mcfaclcap

アプリケーションの異常終了回数の初期化

mcfalstap※²

アプリケーションに関するタイマ起動要求の表示

mcfadltap

アプリケーションに関するタイマ起動要求の削除

mcftactsg

サービスグループの閉塞解除

mcftdctsg

サービスグループの閉塞

mcftlssg

サービスグループの状態表示

mcfthldiq

サービスグループの入力キュー処理の保留

mcftrlsiq

サービスグループの入力キュー処理の保留解除

mcftdlqsg

サービスグループの入力キュー削除

mcfuevt

アプリケーションプログラムの起動

mcftstptr

MCFトレース取得の終了

mcftstrtr

MCFトレース取得の開始

mcftlscom

MCF通信サービスの状態参照

mcftlsutm※²

ユーザタイマ監視の状態表示

注※1

このコマンドを使用する場合，TP1/NET/High Availabilityが必要です。

注※2

このコマンドを使用する場合，TP1/Messaging - Extension 1が必要です。

3.3　MHPのオペレーション

3.3.1　GUIの画面からのオペレーション（MHP）

MHPのオペレーションは，TP1/LiNKの起動中に行います。

MHPオペレーション時の画面構成を次の図に示します。

図3‒2　MHPオペレーション時の画面構成

アプリケーション管理MHPを起動すると，アプリケーション管理画面が表示されます。

画面の表示項目について説明します。

MHP状態表示部

ユーザサーバ状態

MHPのユーザサーバの状態を表示します。

ユーザサーバ状態は，この画面内にある［最新情報に更新（L）］ボタンをクリックした場合も，同様に表示されます。

ユーザサーバ名

MHPのユーザサーバ名を表示します。

サービスグループ名

MHPのユーザサーバのサービスグループ名を表示します。

常駐　非常駐

MHPのユーザサーバの常駐，および非常駐プロセス数を表示します。

［起動（S）］ボタン

MHP状態表示部で選択されているMHPユーザサーバを起動します。

［停止（T）］ボタン

MHP状態表示部で選択されているMHPユーザサーバを停止します。

［最新情報に更新（L）］ボタン

MHPユーザサーバの情報を更新し最新のものにします。このボタンをクリックすると，MHP状態表示部にすべてのMHPユーザサーバの最新の状態が表示されます。

［強制停止（O）］ボタン

MHP状態表示部で選択されているMHPユーザサーバを強制停止します。

［サービス詳細（A）］ボタン

MHP状態表示部で選択されているMHPユーザサーバのサービスグループについて，サービスの詳細を表示します。MHPユーザサーバ名を選択してこのボタンをクリックすると，サービス状態表示画面が表示されます。

画面の詳細については，「3.3.1(2)　サービスの管理」を参照してください。

［閉塞（D）］ボタン

MHP状態表示部で選択されているMHPユーザサーバを閉塞します。

［閉塞解除（R）］ボタン

MHP状態表示部で選択されているMHPユーザサーバを閉塞解除します。

［プログラムのサーチパス（P）］ボタン

MHPのアプリケーションが格納されているディレクトリのパス名を表示します。このボタンをクリックすると，サーチパス画面が表示されます。

［サーバ定義（E）］ボタン

MHPユーザサーバの環境を設定します。MHP状態表示部でMHPを選択しないでこのボタンをクリックすると，アプリケーション環境画面が表示されます。MHPを選択してこのボタンをクリックすると，MHP環境設定画面が表示されます。

MHPの環境設定の詳細については，「2.3　実行環境の設定」を参照してください。

［終了（C）］ボタン

MHPのオペレーションを終了します。

上記に示すボタンには，OpenTP1で実行する運用コマンドに対応しているものがあります。それぞれのボタンと運用コマンドとの対応を次の表に示します。

表3‒4　オペレーションボタンと対応する運用コマンド（TP1/Messagingアプリケーション管理MHP画面）

オペレーションボタン

実行される運用コマンド

［起動］ボタン

dcsvstrt

［停止］ボタン

dcsvstop

［最新の情報に更新］ボタン

prcls

［強制停止］ボタン

dcsvstop

［サービス詳細］ボタン

mcftlssg

［閉塞］ボタン

mcftdctsg

［閉塞解除］ボタン

mcftactsg

［プログラムのサーチパス］ボタン

−

［サーバ定義］ボタン

−

［終了］ボタン

−

（凡例）

−：対応するコマンドがないことを示します。

メニューバー

［ファイル（F）］メニュー

このメニューから，［終了（X）］をクリックすると，MHPのオペレーションを終了します。

［ヘルプ（H）］メニュー

このメニューから，［バージョン情報］をクリックすると，バージョン情報が表示されます。表示内容は，MCFのオペレーションの場合と同じです。詳細については，「3.2.1(3)　バージョン情報の表示」を参照してください。

(1)　MHPユーザサーバの管理

(a)　MHPユーザサーバの起動

MHP状態表示部からMHPユーザサーバ名を選択し，［起動（S）］ボタンをクリックすると，選択したMHPユーザサーバが起動されます。このとき選択できるのは，ユーザサーバ状態が「停止中」のユーザサーバです。

MHPユーザサーバが正常に起動された場合は，該当するMHPの状態表示部の情報が更新されます。正常に起動されなかった場合はエラーとなり，メッセージが表示されます。

(b)　MHPユーザサーバの停止

MHP状態表示部からMHPユーザサーバ名を選択し，［停止（T）］ボタンをクリックすると，選択したMHPユーザサーバが停止されます。このとき停止できるのは，ユーザサーバ状態が「閉塞」または「閉塞解除」のユーザサーバです。

MHPユーザサーバが正常に停止された場合は，該当するMHPの状態表示部の情報が更新されます。正常に停止されなかった場合はエラーとなり，メッセージが表示されます。

(c)　MHPユーザサーバの強制停止

MHP状態表示部からMHPユーザサーバ名を選択し，［強制停止（O）］ボタンをクリックすると，選択したMHPユーザサーバが強制停止されます。このとき強制停止できるのは，ユーザサーバ状態が「閉塞」または「閉塞解除」のユーザサーバです。

MHPユーザサーバが正常に強制停止された場合は，該当するMHPの状態表示部の情報が更新されます。正常に強制停止されなかった場合はエラーとなり，メッセージが表示されます。

(d)　サービスグループの閉塞解除

MHP状態表示部からMHPユーザサーバのサービスグループ名を選択し，［閉塞解除（R）］ボタンをクリックすると，選択したサービスグループが閉塞解除されます。このとき閉塞解除できるのは，ユーザサーバ状態が「閉塞」のサービスグループです。

サービスグループが正常に閉塞解除された場合は，該当するMHPの状態表示部の情報が更新されます。正常に閉塞解除されなかった場合はエラーとなり，メッセージが表示されます。

(e)　サービスグループの閉塞

MHP状態表示部からMHPユーザサーバのサービスグループ名を選択し，［閉塞（D）］ボタンをクリックすると，選択したサービスグループが閉塞されます。このとき閉塞できるのは，ユーザサーバ状態が「閉塞解除」のサービスグループです。

サービスグループが正常に閉塞された場合は，該当するMHPの状態表示部の情報が更新されます。正常に閉塞されなかった場合はエラーとなり，メッセージが表示されます。

(f)　MHPユーザサーバおよびサービスグループの状態表示

アプリケーション管理画面の［最新情報に更新（L）］ボタンをクリックすると，表示されているすべてのMHPについて，最新の情報を取得します。情報が正常に取得された場合は，MHP状態表示部に状態が表示されます。正常に取得されなかった場合は，エラーとなり，メッセージが表示されます。

(2)　サービスの管理

サービスの状態を表示する場合，またはサービスに対してオペレーションをする場合は，MHP状態表示部からサービスグループ名を選択し，［サービス詳細（A）］ボタンをクリックしてください。

画面に表示されている項目について説明します。

サービスグループ名

アプリケーション管理画面のMHP状態表示部で選択したサービスグループ名を表示します。

サービス状態表示部

状態

サービス名に示すサービスの状態を表示します。

この表示は，画面内の［最新情報（N）］ボタンをクリックした場合も，表示されます。

サービス名

サービスグループ名に示すサービスグループに属するサービスを一覧で表示します。

［サービス閉塞（D）］ボタン

サービス状態表示部で選択されているサービスを閉塞します。

［サービス閉塞解除（A）］ボタン

サービス状態表示部で選択されているサービスを閉塞解除します。

［最新情報（N）］ボタン

サービスグループ名に示すサービスグループに属するすべてのサービスの最新情報を，サービス状態表示部に表示します。

［終了（C）］ボタン

サービス状態の表示を終了します。

このボタンをクリックすると，アプリケーション管理画面に戻ります。

上記に示すボタンには，OpenTP1で実行する運用コマンドに対応しているものがあります。それぞれのボタンと運用コマンドとの対応を次の表に示します。

表3‒5　オペレーションボタンと対応する運用コマンド（サービス状態表示画面）

オペレーションボタン

実行される運用コマンド

［サービス閉塞］ボタン

mcftdctsv

［サービス閉塞解除］ボタン

mcftactsv

［最新情報］ボタン

mcftlssv

［終了］ボタン

−

（凡例）

−：対応するコマンドがないことを示します。

次に，サービス状態表示画面で行うオペレーションについて説明します。

(a)　サービスの閉塞解除

サービス状態表示部からサービス名を選択し，［サービス閉塞解除（A）］ボタンをクリックします。このとき選択できるのは，状態が「閉塞」のサービスです。また，閉塞解除するサービスは複数選択できます。

(b)　サービスの閉塞

サービス状態表示部からサービス名を選択し，［サービス閉塞（D）］ボタンをクリックします。このとき選択できるのは，状態が「閉塞解除」のサービスです。また，閉塞するサービスは複数選択できます。

(c)　サービスの状態の表示

サービス状態表示画面の［最新情報（N）］ボタンをクリックすると，表示されているすべてのサービスについて，最新の情報を取得します。情報が正常に取得された場合は，サービス状態表示欄の情報が更新されます。正常に取得されなかった場合は，エラーとなり，メッセージが表示されます。

(d)　サービスのオペレーションの終了

サービス状態表示画面の［終了（C）］ボタンをクリックすると，サービスのオペレーションを終了し，アプリケーション管理画面に戻ります。

(3)　プログラムのサーチパス

プログラムのサーチパスとは，アプリケーションがどのディレクトリにあるかを示す機能です。アプリケーションが属しているディレクトリまでの階層構造を，一つの連続した名称（パス名）で表現しています。サーチパス機能を使用することで，目的のアプリケーションがどのようなディレクトリを通って格納されているかが確認できます。

アプリケーション管理画面の［プログラムのサーチパス（P）］ボタンをクリックすると，サーチパス画面が表示されます。

サーチパス画面に表示されている項目について説明します。

サーチパス状態（P）

TP1/Messagingで設定されているすべてのサーチパスが表示されます。六つ以上のサーチパスが設定された場合，この欄の右側にスクロールバーが表示されます。

変更サーチパス名（N）

設定，または削除するサーチパス名を表示します。

サーチパス名は，キーボードから直接入力するか，またはサーチパス状態欄に表示されている名称を選択し，表示させてください。

［設定（S）］ボタン

変更サーチパス名に表示されているサーチパスを設定します。

［削除（D）］ボタン

変更サーチパス名に表示されているサーチパスを削除します。

［終了（C）］ボタン

サーチパスを終了し，アプリケーション管理画面に戻ります。

上記に示すボタンには，OpenTP1で実行する運用コマンドに対応しているものがあります。それぞれのボタンと運用コマンドとの対応を次の表に示します。

表3‒6　オペレーションボタンと対応する運用コマンド（TP1/Messagingサーチパス画面）

オペレーションボタン

実行される運用コマンド

［設定］ボタン

prcpath

［削除］ボタン

prcpath

［終了］ボタン

−

（凡例）

−：対応するコマンドがないことを示します。

サーチパス画面で行えるオペレーションを次に示します。

(a)　サーチパスの参照

サーチパス状態欄に表示されているサーチパスから，該当するサーチパスを参照します。

(b)　サーチパスの設定

変更サーチパス名欄に，設定するサーチパス名を直接入力し，［設定（S）］ボタンをクリックしてください。サーチパスが正常に設定された場合は，サーチパス状態欄に新しいサーチパスが表示されます。正常に設定されなかった場合は，エラーとなり，メッセージが表示されます。

(c)　サーチパスの削除

サーチパス状態欄から，削除するサーチパス名を選択し，変更サーチパス名欄に表示させてから，［削除（D）］ボタンをクリックしてください。サーチパスが正常に削除された場合は，サーチパス状態欄から該当するサーチパスが削除されます。正常に設定されなかった場合は，エラーとなり，メッセージが表示されます。

(d)　サーチパスのオペレーションの終了

サーチパス画面の［終了（C）］ボタンをクリックすると，サーチパスのオペレーションが終了し，アプリケーション管理画面に戻ります。

(4)　バージョン情報の表示

アプリケーション管理画面のメニューバーで［ファイル（F）］を選択し，［バージョン情報］をクリックすると，バージョン情報が表示されます。表示内容は，MCFオペレーションの場合と同じです。詳細については，「3.2.1(3)　バージョン情報の表示」を参照してください。

表示内容を確認後，［OK］ボタンをクリックすると，アプリケーション管理画面に戻ります。

(5)　MHPのオペレーションの終了

サービス状態表示画面，およびサーチパス画面のオペレーションを終了する場合は，それぞれの画面に表示されている［終了（C）］ボタンをクリックします。

MHPのオペレーションをすべて終了する場合は，アプリケーション管理画面の［終了（C）］ボタンをクリックしてください。

3.3.2　コマンドプロンプト画面からのオペレーション（MHP）

TP1/LiNKが起動されている状態で，コマンドプロンプト画面からMHPのオペレーションができます。オペレーションは，MHPの運用コマンドを実行して行います。

TP1/Messagingで実行できるMHPの運用コマンドを次の表に示します。表に示す運用コマンド，およびその他の運用コマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

表3‒7　TP1/Messagingで実行できるMHPの運用コマンド

運用コマンド名

機能

mcftactsv

サービスの閉塞解除

mcftdctsv

サービスの閉塞

mcftlssv

サービスの状態表示

mcftactsg

サービスグループの閉塞解除

mcftdctsg

サービスグループの閉塞

mcftlssg

サービスグループの状態表示

4　トラブルが発生したら

この章では，TP1/Messagingで発生するトラブルと，ユーザの対処について説明します。

4.1　トラブルの種類と原因

TP1/Messagingで発生するトラブルの具体的な現象と対処方法を説明します。

TP1/Messaging運用中に，TP1/LiNKにトラブルが発生した場合の対応については，マニュアル「TP1/LiNK 使用の手引」を参照してください。

4.1.1　TP1/Messagingのトラブル

(1)　TP1/Messagingを開始できない場合

TP1/Messagingを開始できない原因には，次の理由が考えられます。

(a)　TP1/Messagingが正しくセットアップされていない

TP1/Messagingをセットアップし直してください。セットアップし直す場合は，１度アンインストールしてから，再度インストールしてください。

(b)　メモリの容量不足，またはディスクの容量不足

メモリ，またはディスクの容量が不足していることを知らせるメッセージが出力されます。

稼働中の不要なユーザサーバを停止させるか，または不要なファイルを削除してから，TP1/Messagingを再び開始させてください。

(c)　MCFまたはMHPの環境設定が正しく行われていない

MCFまたはMHPの環境設定を，GUIの画面から再度行ってください。次の表に示す環境設定不正の要因と対策を参照して定義の設定を見直してください。

表4‒1　環境設定不正の要因と対策

設定種別

画面名称

設定項目

要因と対策

MCF環境設定

TCP/IPコネクション属性設定画面

［コネクション名（N）］

コネクション名がOpenTP1システム内で重複していることが考えられます。OpenTP1システム内で一意となるように名称を変更してください。

［論理端末名（L）］

論理端末名がOpenTP1システム内で重複していることが考えられます。OpenTP1システム内で一意となるように名称を変更してください。

［アプリケーション名（A）］

次に示す設定内容が一致していないことが考えられます。設定内容が一致するように変更してください。

TCP/IP通信サービス環境設定画面で設定したアプリケーショングループ名とアプリケーション名

アプリケーショングループ環境設定での設定内容

［コネクションリプレースの使用］

TCP/IP通信サービス環境設定画面で設定するコネクション内で，同じ自システムのポート番号を持つサーバ型コネクションが複数ある場合は，コネクションリプレースを使用する／使用しないの設定値が統一されていないことが考えられます。設定値を統一してください。

定義テキストファイルの内容の不正によってGUIを起動できなくなった場合は，次に示す手順でバックアップファイルから定義情報を元の状態に戻すことができます。

各定義テキストファイル格納フォルダ内の定義テキストファイル，および各定義オブジェクトファイル格納フォルダ内の定義オブジェクトファイルをすべて削除してください。ただし，表4-2に示す初期設定ファイルは削除しないでください。

定義テキストファイルのバックアップファイルの拡張子（.bak）を削除して，定義テキストファイルの格納フォルダにコピーしてください。

表4-3に定義テキストファイルのバックアップファイルのファイルパスを示します。

GUIを再起動してください。

表4‒2　初期設定ファイルの格納フォルダ

定義種別

ファイルパス名

（TEXTPATH=%DCCONFPATH%¥mcfconf¥TEXT）

マネジャ定義

TEXTPATH¥MNG¥mcfmngr.mng

アプリケーション定義

TEXTPATH¥APL¥mcfag01.apl

アプリケーション間通信サービス定義

通信構成定義共通部

TEXTPATH¥PSV¥CCM¥mups01.ccm

アプリケーション起動環境定義

TEXTPATH¥PSV¥CPR¥mups01.psv

TCP/IP通信サービス定義

通信構成定義共通部

TEXTPATH¥TCP¥CCM¥mutc01.ccm

TCP/IP定義

TEXTPATH¥TCP¥CPR¥mutc01.tip

表4‒3　定義テキストファイルのバックアップファイルの格納フォルダ

定義種別

ファイルパス名

（TEXTPATH=%DCCONFPATH%¥mcfconf¥_TEXT_BACKUP）

マネジャ定義

TEXTPATH¥MNG¥mcfmngr.bak

アプリケーション定義

TEXTPATH¥APL¥アプリケーショングループ名.bak

アプリケーション間通信サービス定義

通信構成定義共通部

TEXTPATH¥PSV¥CCM¥アプリケーション間通信サービス名.bak

アプリケーション起動環境定義

TEXTPATH¥PSV¥CPR¥アプリケーション間通信サービス名.bak

TCP/IP通信サービス定義

通信構成定義共通部

TEXTPATH¥TCP¥CCM¥TCP/IP通信サービス名.bak

TCP/IP定義

TEXTPATH¥TCP¥CPR¥TCP/IP通信サービス名.bak

ユーザサービス定義

%DCCONFPATH%¥_MHP_BACKUP¥ユーザサーバ名.bak

定義ソースファイルを直接編集して環境設定をしている場合は，マネジャ定義オブジェクトファイル名に注意してください。TP1/Messagingでは，マネジャ定義オブジェクトファイル名は必ず'_mumngr'としてください。誤ったファイル名で作成している場合は，'_mumngr'で再作成してください。

また，テキストファイル%DCCONFPATH%¥sysconfに次のとおり記述されているか確認してください。'_mumngr'でない場合は，'_mumngr'に修正してください。

dcsvstrt -m _mumngr

(2)　TP1/Messagingを終了できない場合

TP1/Messagingのアプリケーション管理MHPの画面，TP1/LiNKアプリケーション管理SPPの画面，またはTP1/LiNKアプリケーション管理SUPの画面から，［最新情報に更新（L）］ボタンをクリックして，現在のユーザサーバの状態を確認してください。ユーザサーバが終了していない場合は，終了を待つか，または終了していないユーザサーバを強制停止させてください。

(3)　TP1/Messagingが異常終了した場合

TP1/Messagingの内部処理で異常を検出した場合，メッセージ，および異常の原因を示す理由コードが出力されます。これらの情報を保守員へ連絡してください。

(4)　定義内容の矛盾によってエラーが発生した場合

MCF環境設定とMHP環境設定で設定する定義内容に矛盾がある場合，エラーダイアログボックスが表示されることがあります。エラーダイアログボックスが表示された場合は，ここで説明する事例と対策方法を参考にしてエラーの要因を取り除いてください。問題が解決しない場合は，保守員に連絡してください。

(a)　サービスグループ名の不一致

アプリケーション管理MHPのGUI画面を操作中に，次に示すエラーダイアログボックスが表示されることがあります。

このエラーダイアログボックスが表示される要因と対策を次に示します。

要因

GUIで環境設定をする場合

アプリケーション属性設定画面で設定したサービスグループ名とMHP環境設定で設定したサービスグループ名との間に，一致するサービスグループがない場合に発生します。

定義ソースファイルを直接編集して環境設定をする場合

アプリケーション属性定義のservgrpnオペランドで設定したサービスグループ名とMHP環境設定画面で設定したサービスグループ名との間に，一致するサービスグループがない場合に発生します。

対策

アプリケーション属性設定画面で設定したサービスグループ名，またはアプリケーション属性定義のservgrpnオペランドで設定したサービスグループ名とMHP環境設定画面で設定したサービスグループ名が一致するように再度環境設定をしてください。

(b)　サービス名の不一致

アプリケーション管理MHPのGUI画面を操作中に，次に示すエラーダイアログボックスが表示されることがあります。

このエラーダイアログボックスが表示される要因と対策を次に示します。

要因

GUIで環境設定をする場合

アプリケーション属性設定画面で設定したサービス名とMHP環境設定画面で設定したサービス名との間に，一致するサービスがない場合に発生します。

定義ソースファイルを直接編集して環境設定をする場合

アプリケーション属性定義のservnameオペランドで設定したサービス名とMHP環境設定画面で設定したサービス名との間に，一致するサービスがない場合に発生します。

対策

アプリケーション属性設定画面で設定したサービス名，またはアプリケーション属性定義のservnameオペランドで設定したサービス名とMHP環境設定画面で設定したサービス名が一致するように再度環境設定をしてください。

4.2　トラブルシュート情報

TP1/Messagingでは，障害対策用に，次のファイルを作成します。

MCFイベントトレースファイル

TP1/Messagingでは，各プロセスで発生したイベントや，送受信データなどの情報を取得しています。これらの情報をMCFイベントトレースといい，MCFイベントトレースを格納するファイルを，MCFイベントトレースファイルといいます。MCFイベントトレースファイルは，%DCDIR%¥SPOOL%ディレクトリの下にmcft××××というファイル名で出力されます。

MCFイベントトレースファイルを強制的にスワップして参照したい場合は，コマンドプロンプト画面からmcftswptrコマンドを入力してください。スワップする直前までのMCFイベントトレースが参照できます。

mcftswptrコマンドの詳細については，マニュアル「OpenTP1 運用と操作」を参照してください。

MCFダンプファイル

TP1/Messagingのローカルメモリおよび共用メモリをダンプするファイルです。%DCDIR%¥SPOOLディレクトリの下にmcfd××××というファイル名で出力されます。

コアダンプファイル

異常終了したプロセスのコアを退避するファイルです。%DCDIR%¥SPOOL¥SAVEディレクトリの下にサーバ名.nというファイル名で出力されます。nは1けたの数字です。

注意事項

障害が発生した場合は，上記に示すファイルを確保してから，保守員へ連絡してください。

4.3　メッセージ

TP1/Messagingでは，システム情報やエラーをメッセージで通知します。メッセージは，ダイアログボックスで画面に表示されます。

表示されるメッセージには，値の設定や操作が適切でないときに，エラーとして通知するものと，システムの動作またはユーザの操作について，確認するものとがあります。

エラーメッセージが通知された場合

表示された内容について，設定した値やコマンドの操作が正しいかどうかを確認してください。必要な場合は設定をし直すなどの処置をしてください。

メッセージの最後に「しばらくお待ちください。」という説明がある場合

TP1/Messagingが内部処理を終了していません。内部処理終了後，次の操作を行ってください。

ダイアログボックス内の説明にシステムメッセージが付いている場合

システムメッセージのメッセージID（KFCA×××××）を基に，マニュアルを参照して対処してください。

システムメッセージについては，マニュアル「OpenTP1 メッセージ」を参照してください。

上記以外で，ユーザ側で対処できないトラブルが発生したときは，保守員に連絡してください。

付録

付録A　TP1/MessagingとMCFの差異

＜参照するマニュアルの制限事項＞

このマニュアルでは，OpenTP1の機能，定義，運用コマンド，および関数の説明に関して，OpenTP1の関連マニュアルを参照している個所があります。関連マニュアルは，TP1/Messagingで使用できない機能，定義，運用コマンド，および関数についても説明しています。関連マニュアルを参照する場合は，TP1/Messagingで使用できる機能，定義，運用コマンド，および関数かどうかを確認してください。

ここでは，機能，定義，運用コマンド，および関数について，TP1/Messagingのメッセージ送受信機能と，TP1/Message Control，TP1/NET/Library，およびTP1/NET/TCP/IPで実現するメッセージ送受信機能の差異を示します。

一覧表で使用している記号の凡例を次に示します。

（TP1/Messagingでのサポートの有無に関する凡例）

○：MCFと同じ機能をサポートしています。

△：MCFとの機能差異やTP1/Messagingでの制限事項があります。

×：サポートしていません。

（TP1/Messaging - Extension 1の要否に関する凡例）

○：TP1/Messaging - Extension 1が必要です※。

×：TP1/Messaging - Extension 1が不要です。

−：該当しません。

注※

TP1/Messaging - Extension 1をインストールしていない場合の動作は保証できません。

付録A.1　TP1/MessagingとMCFの機能の差異

TP1/Messagingでは使えないMCFの機能を，次に示します。

正常終了

計画停止B

強制正常終了

再開始時の状態引き継ぎ

開始処理高速化

メッセージの再送

MCFからのSPP起動

メモリキューでの縮退運転

キューサービス（ディスクキュー）

MCF部分入れ替え

MCFオンラインテスタ

ジャーナル取得

MCF稼働統計情報

UOC

OpenTP1セキュリティ

マッピングサービス

共用メモリ自動増分時のログ出力

MCF構成変更再開始

再開始時のエラーイベント引き継ぎ

UOCへのアプリケーション情報通知

異常終了MHPの再スケジュール順序変更

データ操作言語（DML）

同期受信

継続問い合わせ応答

注意事項

TP1/Messagingでは，OpenTP1のUOC（ユーザオウンコーディング）機能は使用できません。そのため，MCFメイン関数の作成，およびディレクトリの組み込みは必要ありません。

付録A.2　TP1/MessagingとMCFの定義の差異

TP1/MessagingとMCFの定義の差異を，次に示します。

表A‒1　MCFマネジャ定義の差異

形式

コマンド

オプション

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コマンド

mcfmenv

-m

id

MCFマネジャプロセス識別子

×

−

name

MCFマネジャ名

○

×

mcfmcomn

-n

出力通番を使用する論理端末数

○

×

-p

MCF作業領域長

△※

×

-i

MCF作業領域を追加確保した場合に，KFCA10242-Iメッセージを出力するかどうかを指定

×

−

-j

MCFマネジャプロセスのジャーナルバッファの大きさ

×

−

-o

cmdsvname

MCFオンラインコマンドサービス名

×

−

-w

stats

MCF稼働統計情報を取得するかどうかを指定

×

−

mcfmcname

-s

mcfsvname

MCF通信サービス名

○

×

syssvname

システムサービス情報定義ファイル名

○

×

mcfmuap

-d

通信関数の発行回数の上限値

○

×

-t

sndtim

同期型送信監視時間

○

×

sndrcvtim

同期型送受信監視時間

○

×

recvtim

同期型受信監視時間

○

×

-j

ユーザサービスのジャーナルバッファの大きさ

×

−

-e

segsize

エラーイベント処理用MHP起動時，またはアプリケーション起動機能使用時の最大セグメント長

△※

×

-l

initseq

出力通番の初期値

○

×

maxseq

ラップ時の出力通番の最大値

○

×

minseq

ラップ後の出力通番の開始値

○

×

-u

ntmetim

非トランザクションMHP限界経過時間

○

×

-a

delaytim

アプリケーション起動時の遅延許容時間

○

×

-c

order

メッセージ送信順序および再送順序ならびにアプリケーション起動順序の選択

○

×

noansreply

非応答型のMHPからの問い合わせ応答をするかどうかを指定

△※

○

commitdml

データ操作言語のCOMMIT文を使用するかどうかを指定

×

−

otqinhold

出力キューの入力保留中の動作を指定

○

×

errevt_recovery

OpenTP1再開始時のエラーイベントを引き継ぐかどうかを指定

×

−

itqretryorder

MHPの再スケジュール時に受信メッセージを入力キューに格納する位置

×

−

-r

reschedulecnt

アプリケーション異常終了時の再スケジュール回数

○

○

rescheduleint

アプリケーション異常終了時の再スケジュール間隔

○

○

reschedulelog

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

○

○

mcfmqgid

-q

quekind

キュー種別

×

−

quegrpid

キューグループID

×

−

mcfmexp

-g

サービスグループの登録数

×

−

-l

論理端末の登録数

×

−

-i

入力用ディスクキューが使用できないときに縮退運転するかどうかを指定

×

−

-o

出力用ディスクキューが使用できないときに縮退運転するかどうかを指定

×

−

mcfmsts

-g

サービスグループ数上限値

×

−

-v

サービス数上限値

×

−

mcfmsmsg

-m

ログファイルへの出力を抑止するメッセージID

○

○

mcfmsvg

-g

servgrpn

サービスグループ名

○

○

-w

watchcnt

入力キューの滞留監視数

○

○

watchint

入力キューの滞留監視インタバル時間

○

○

expectcnt

MHPに期待するサービス要求の処理数

○

○

abort

MHPの処理能力不足時のOpenTP1システムのダウン可否

○

○

注※

詳細については，「付録A.5　TP1/MessagingとMCFの仕様差異」を参照してください。

表A‒2　MCF通信構成定義共通部の差異

形式

コマンド

オプション

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コマンド

mcftenv

-s

MCF通信プロセス識別子，またはアプリケーション起動プロセス識別子

△※

×

-m

MCFマネジャ識別子

×

−

-a

MCFアプリケーション定義オブジェクトファイル名

○

×

-q

diskitq

入力キューにディスクキューを使用するかどうかを指定

×

−

mcftcomn

-j

MCF通信プロセス，またはアプリケーション起動プロセスのジャーナルバッファの大きさ

×

−

mcfttred

-m

最大処理多重度

△※

×

mcfttim

-t

btim

時間監視間隔

○

×

mtim

未処理送信メッセージ滞留時間

○

×

rmtim

未処理受信メッセージ滞留時間

○

×

-p

usertime

ユーザタイマ監視機能を使用するかどうかを指定

○

×

timereqno

最大タイマ監視要求数

○

×

msgsize

最大メッセージ長

○

×

msgout

メッセージを出力するかどうかを指定

○

×

mcfttrc

-t

size

MCFトレースバッファの大きさ

○

×

disk

MCFトレースディスク出力機能を使用するかどうかを指定

○

×

bufcnt

MCFトレースバッファの数

○

×

trccnt

MCFトレースファイルの数

○

×

msgsize

トレースとして取得する送受信メッセージの最大サイズ

○

×

-m

MCFトレースファイルの数を超えたときの処置

○

×

mcftsts

-a

アプリケーション数上限値

×

−

-l

論理端末数上限値

×

−

mcftbuf

-g

groupno

メッセージ送受信用，およびメッセージ編集用バッファグループ番号

○

×

length

メッセージ送受信用，およびメッセージ編集用バッファ長

○

×

count

メッセージ送受信用，およびメッセージ編集用バッファ数

○

×

extend

拡張するバッファ数

×

−

注※

詳細については，「付録A.5　TP1/MessagingとMCFの仕様差異」を参照してください。

表A‒3　アプリケーション起動環境定義の差異

形式

コマンド

オプション

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コマンド

mcftpsvr

-c

内部通信路名

○

×

-o

reruntm

リラン時のタイマ起動を引き継ぐかどうかを指定

×

−

mcftalcle

-l

論理端末名称

○

×

-t

論理端末の端末タイプ

○

×

-m

mmsgcnt

メモリ出力メッセージ最大格納数

×

−

dmsgcnt

ディスク出力メッセージ最大格納数

×

−

-k

quekind

出力メッセージの割り当て先

×

−

quegrpid

キューグループID

×

−

mcftped

アプリケーション起動環境定義の終了

○

×

表A‒4　MCFアプリケーション定義の差異

形式

コマンド

オプション

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コマンド

mcfaenv

-a

MCFアプリケーション定義識別子

○

×

-p

アプリケーション起動プロセス識別子

△※

×

mcfaalcap※

-n

name

アプリケーション名，またはMCFイベント名

○

×

kind

アプリケーション種別

○

×

type

アプリケーションの型

△※

×

aplihold

アプリケーション異常終了時のアプリケーションの処置

○

×

msgcnt

入力メッセージ最大格納数

○

×

lname

論理端末名称

○

×

cname

内部通信路名

○

×

tempsize

継続問い合わせ応答用一時記憶データ格納用領域サイズ

×

−

trnmode

アプリケーションのトランザクション属性

○

×

errevt

通信イベント障害時のエラーイベントを通知するかどうかを指定

○

○

replychk

応答送信チェックをするかどうかを指定

○

○

-N

modelname

モデルアプリケーション名，またはモデルMCFイベント名

○

○

-g

servgrpn

アプリケーション名に対応するサービスグループ名

○

×

quegrpid

キューグループID

×

−

quekind

入力メッセージの割り当て先

×

−

srvghold

アプリケーション異常終了時のサービスグループの処置

○

×

recvmsg

異常終了したUAPの受信メッセージの扱い

×

−

-v

servname

アプリケーション名に対応するサービス名

○

×

servhold

アプリケーション異常終了時のサービスの処置

○

×

ntmetim

非トランザクションMHP限界経過時間

○

×

-d

holdlimit

アプリケーション異常終了限界回数

○

×

holdlmtyp

アプリケーション異常終了回数のカウント方法

○

×

reschedulecnt

アプリケーション異常終了時の再スケジュール回数

○

○

rescheduleint

アプリケーション異常終了時の再スケジュール間隔

○

○

reschedulelog

異常終了したアプリケーションを再スケジュールするときに，ログメッセージを出力するかどうかを指定

○

○

-j

ij

他システムから受信したメッセージの入力キュー登録時に，履歴情報を取得するかどうかを指定

×

−

oj

UAPからのメッセージ送信要求時に，履歴情報を取得するかどうかを指定

×

−

gj

UAPからのメッセージ受信要求時に，履歴情報を取得するかどうかを指定

×

−

-e

evtlogout

ERREVT1〜ERREVT4を起動するとき，ログメッセージを出力するかどうかを指定

○

○

注※

詳細については，「付録A.5　TP1/MessagingとMCFの仕様差異」を参照してください。

表A‒5　MCF性能検証用トレース定義の差異

形式

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

set

prf_file_size

MCF性能検証用トレース情報ファイルのサイズ

○

×

prf_file_count

MCF性能検証用トレース情報ファイルの世代数

○

×

表A‒6　システムサービス情報定義の差異

形式

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

set

module

MCF通信サービスを起動するためのMCF実行形式プログラム名

TP1/Messagingでは，システムサービス情報定義は編集できません。

−

mcf_prf_trace

MCF通信サービスごとにMCF性能検証用トレース情報を取得するかどうかを指定

−

表A‒7　システムサービス共通情報定義の差異

形式

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

set

max_socket_descriptors

ソケット用ファイル記述子の最大数

○

○

max_open_fds

MCF通信プロセスでアクセスするファイルの最大数

△※

○

thdlock_sleep_time

スレッド間で排他が競合した場合のスレッドの待ち時間

○

×

mcf_prf_trace_level

MCF性能検証用トレース情報の取得レベル

○

×

mcf_start_watch_interval

MCF開始時プロセス間監視時間間隔

○

○

putenv

DCMCFQUEBAK

MCF構成変更準備停止時のバックアップファイル名

×

−

注※

詳細については，「付録A.5　TP1/MessagingとMCFの仕様差異」を参照してください。

表A‒8　リアルタイム取得項目定義の差異

形式

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

set

rts_mcf_ap_scd_stay

スケジュール待ち情報を取得するかどうかを指定

○

○

rts_mcf_ap_usr_srvc

ユーザサービス実行情報を取得するかどうかを指定

○

○

rts_mcf_in_msg_scd_wait

論理端末単位に受信メッセージの処理待ち情報を取得するかどうかを指定

○

○

rts_mcf_out_msg_sync_scd_wait

同期型送信メッセージの処理待ち情報を取得するかどうかを指定

○

○

rts_mcf_out_msg_resp_scd_wait

問い合わせ応答型送信メッセージの処理待ち情報を取得するかどうかを指定

○

○

rts_mcf_out_msg_prio_scd_wait

優先分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

○

○

rts_mcf_out_msg_norm_scd_wait

一般分岐型送信メッセージの処理待ち情報を取得するかどうかを指定

○

○

rts_mcf_que_scd_wait_num

入力キューの滞留数の情報を取得するかどうかを指定

○

○

表A‒9　MCF通信構成定義TCP/IP固有部の差異

形式

コマンド

オプション

オペランド

定義内容

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コマンド

mcftalccn※¹

-c

コネクションID

○

×

-N

modelname

モデルコネクションID

○

○

-p

プロトコルの種別

○

×

-g

sndbuf

メッセージ送信用バッファグループ番号

○

×

rcvbuf

メッセージ受信用バッファグループ番号

○

×

-e

msgbuf

メッセージ編集用バッファグループ番号

×

−

count

メッセージ編集用バッファ数

×

−

-i

コネクションの確立方法

○

×

-b

bretry

コネクション確立障害時の確立再試行するかどうかを指定

○

×

bretrycnt

コネクション確立障害時の確立再試行回数

○

×

bretryint

コネクション確立障害時の確立再試行間隔

○

×

concmptim

コネクション確立時の監視時間

×

−

sndcmptim

メッセージ送信完了までの監視時間

×

−

-w

srtimout

コネクション切断抑止をするかどうかを指定

○

×

-t

トランスポート層のプロトコルの種別

○

×

-y

mode

クライアントとサーバの種別

○

×

-r

ipaddr

自システムのホストのIPアドレス

×

−

hostname

自システムのホスト名

×

−

portno

自システムのホストのポート番号

○

×

-o

oipaddr

相手システムのホストのIPアドレス

○

×

ohostname

相手システムのホスト名

○

×

oportno

相手システムのホストのポート番号

○

×

-k

keepalive

ソケットオプション「SO_KEEPALIVE」を使用するかどうかを指定

○

×

nodelay

ソケットオプション「TCP_NODELAY」を使用するかどうかを指定

○

○

notrftime

無通信状態監視時間

○

○

-f

kind

相手システムからのコネクション解放の通知

○

×

cnrelease

コネクション解放形態

○

○

releaselog

コネクション解放時のログメッセージの形式

○

×

cnerrlog

障害によるコネクション切断時のログメッセージの形式

○

×

-A

mastercn※2

現用コネクションID

○

×

-u

masm

受信メッセージ組み立て機能を使用するかどうかを指定

△※¹

×

ntimer

後続セグメント受信の監視タイマ

○

×

ntime

後続セグメント受信の監視タイマ値

○

×

delichk

メッセージ送達確認機能を使用するかどうかを指定

△※¹

○

msghold

受信メッセージを保留するかどうかを指定

×

−

holdlimit

受信メッセージの最大保留数

×

−

-h

addrchk

相手アドレス情報のチェックをするかどうかを指定

○

○

chgconn

コネクション確立要求を受け付けた場合，未確立コネクションがなかったときの動作（コネクションリプレース機能を使用するかどうかを指定）

○

×

listen

オンライン開始時から自動的にコネクション確立要求を受け付けるかどうかを指定

○

○

-C

lscnfmt

mcftlscnコマンドの表示形式

×

−

-l

replymsg

問い合わせ応答形態および継続問い合わせ応答形態のメッセージ送受信を行うかどうかを指定

○

○

cnassign

相手からのコネクション確立要求時にコネクションを割り当てる対象の選択

○

○

mcftalcle※¹

-l

論理端末名称

○

×

-N

modelname

モデル論理端末名称

○

○

-t

論理端末の端末タイプ

○

×

-m

mmsgcnt

メモリ出力メッセージ最大格納数

×

−

dmsgcnt

ディスク出力メッセージ最大格納数

×

−

-i

論理端末の閉塞解除方法

○

×

-k

quekind

出力メッセージの割り当て先

×

−

quegrpid

キューグループID

×

−

-o

aj

メッセージ送信完了ジャーナルを取得するかどうかを指定

×

−

-v

アプリケーション名

○

×

-d

replacemsg

コネクション再確立時に未送信メッセージを送信するかどうかを指定（コネクション再確立時の未送信メッセージの送信抑止機能を使用するかどうかを指定）

○

○

mcftalced

コネクション定義の終了

○

×

注※1

詳細については，「付録A.5　TP1/MessagingとMCFの仕様差異」を参照してください。

注※2

このオペランドを指定する場合，TP1/NET/High Availabilityが必要です。

付録A.3　TP1/MessagingとMCFの運用コマンドの差異

TP1/MessagingとMCFの運用コマンドの差異を，次に示します。

表A‒10　運用コマンドの差異

機能

運用コマンド

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

コネクション管理

コネクションの状態表示

mcftlscn

○

×

コネクションの確立

mcftactcn

○

×

コネクションの解放

mcftdctcn

○

×

コネクションの切り替え※

mcftchcn

○

×

ネットワークの状態表示

mcftlsln

○

○

サーバ型コネクションの確立要求の受付開始

mcftonln

○

○

サーバ型コネクションの確立要求の受付終了

mcftofln

○

○

メッセージ多重処理状況の表示

mcftlstrd

○

○

アプリケーション管理

アプリケーションの状態表示

mcfalsap

○

×

アプリケーションの閉塞

mcfadctap

○

×

アプリケーションの閉塞解除

mcfaactap

○

×

アプリケーション異常終了回数の初期化

mcfaclcap

○

×

アプリケーションに関するタイマ起動要求の表示

mcfalstap

○

○

アプリケーションに関するタイマ起動要求の削除

mcfadltap

○

×

アプリケーション運用支援

アプリケーションプログラムの起動

mcfuevt

○

×

論理端末管理

論理端末の状態表示

mcftlsle

○

×

論理端末の閉塞

mcftdctle

○

×

論理端末の閉塞解除

mcftactle

○

×

論理端末のメッセージキューの先頭スキップ

mcftspqle

○

×

論理端末の出力キュー処理の保留

mcfthldoq

○

×

論理端末の出力キュー処理の保留解除

mcftrlsoq

○

×

論理端末の出力キュー削除

mcftdlqle

○

×

論理端末に関するメッセージジャーナルの取得開始

mcftactmj

×

−

論理端末に関するメッセージジャーナルの取得終了

mcftdctmj

×

−

論理端末に対する継続問い合わせ応答処理の強制終了

mcftendct

×

−

代行送信の開始

mcftstalt

×

−

代行送信の終了

mcftedalt

×

−

サービスグループ管理

サービスグループの状態表示

mcftlssg

○

×

サービスグループの閉塞

mcftdctsg

○

×

サービスグループの閉塞解除

mcftactsg

○

×

サービスグループの入力キュー処理の保留

mcfthldiq

○

×

サービスグループの入力キュー処理の保留解除

mcftrlsiq

○

×

サービスグループの入力キュー削除

mcftdlqsg

○

×

サービス管理

サービスの状態表示

mcftlssv

○

×

サービスの閉塞

mcftdctsv

○

×

サービスの閉塞解除

mcftactsv

○

×

バッファ管理

バッファグループの使用状況表示

mcftlsbuf

○

×

マップ管理

マップファイルのパス名変更

dcmapchg

×

−

マップファイルのロード済み資源の表示

dcmapls

×

−

キュー管理

入出力キューの内容複写

mcftdmpqu

×

−

MCFトレース取得管理

MCFトレースファイルの強制スワップ

mcftswptr

○

×

MCFトレース取得の開始

mcftstrtr

○

×

MCFトレース取得の終了

mcftstptr

○

×

MCF稼働統計情報管理

MCF稼働統計情報の編集

mcfreport

×

−

MCF稼働統計情報の出力

mcfstats

×

−

MCF通信サービス管理

MCF通信サービスの部分停止

mcftstop

×

−

MCF通信サービスの部分開始

mcftstart

×

−

MCF通信サービスの状態参照と開始待ち合わせ

mcftlscom

○

×

ユーザタイマ管理

ユーザタイマ監視の状態表示

mcftlsutm

○

○

注※

このコマンドを使用する場合，TP1/NET/High Availabilityが必要です。

付録A.4　TP1/MessagingとMCFの関数の差異

TP1/MessagingとMCFの関数の差異を，次に示します。

表A‒11　関数の差異

機能

関数名※

TP1/Messagingでのサポートの有無

TP1/Messaging - Extension 1の要否

メッセージ送受信

アプリケーションに関するタイマ起動要求の削除

dc_mcf_adltap

CBLDCMCF('ADLTAP△△')

○

○

アプリケーション情報通知

dc_mcf_ap_info

CBLDCMCF('APINFO△△')

○

○

UOCへのアプリケーション情報通知

dc_mcf_ap_info_uoc

−

×

−

MCF環境のクローズ

dc_mcf_close

CBLDCMCF('CLOSE△△△')

○

×

MHPのコミット

dc_mcf_commit

CBLDCMCF('COMMIT△△')

○

×

継続問い合わせ応答の終了

dc_mcf_contend

CBLDCMCF('CONTEND△')

×

−

アプリケーションプログラムの起動

dc_mcf_execap

CBLDCMCF('EXECAP△△')

○

×

MHPのサービス開始

dc_mcf_mainloop

CBLDCMCF('MAINLOOP')

○

×

MCF環境のオープン

dc_mcf_open

CBLDCMCF('OPEN△△△△')

○

×

メッセージの受信

dc_mcf_receive

CBLDCMCF('RECEIVE△')

○

×

同期型のメッセージの受信

dc_mcf_recvsync

CBLDCMCF('RECVSYNC')

×

−

応答メッセージの送信

dc_mcf_reply

CBLDCMCF('REPLY△△△')

○

○

メッセージの再送

dc_mcf_resend

CBLDCMCF('RESEND△△')

×

−

MHPのロールバック

dc_mcf_rollback

CBLDCMCF('ROLLBACK')

○

×

メッセージの送信

dc_mcf_send

CBLDCMCF('SEND△△△△')

○

×

同期型のメッセージの送受信

dc_mcf_sendrecv

CBLDCMCF('SENDRECV')

○

×

同期型のメッセージの送信

dc_mcf_sendsync

CBLDCMCF('SENDSYNC')

○

○

コネクションの確立

dc_mcf_tactcn

CBLDCMCF('TACTCN△△')

○

○

論理端末の閉塞解除

dc_mcf_tactle

CBLDCMCF('TACTLE△△')

○

○

コネクションの解放

dc_mcf_tdctcn

CBLDCMCF('TDCTCN△△')

○

○

論理端末の閉塞

dc_mcf_tdctle

CBLDCMCF('TDCTLE△△')

○

○

論理端末の出力キュー削除

dc_mcf_tdlqle

CBLDCMCF('TDLQLE△△')

○

○

一時記憶データの受け取り

dc_mcf_tempget

CBLDCMCF('TEMPGET△')

×

−

一時記憶データの更新

dc_mcf_tempput

CBLDCMCF('TEMPPUT△')

×

−

ユーザタイマ監視の取り消し

dc_mcf_timer_cancel

CBLDCMCF('TIMERCAN')

○

×

ユーザタイマ監視の設定

dc_mcf_timer_set

CBLDCMCF('TIMERSET')

○

×

コネクションの状態取得

dc_mcf_tlscn

CBLDCMCF('TLSCN△△△')

○

○

MCF通信サービスの状態取得

dc_mcf_tlscom

CBLDCMCF('TLSCOM△△')

○

○

論理端末の状態取得

dc_mcf_tlsle

CBLDCMCF('TLSLE△△△')

○

○

サーバ型コネクションの確立要求の受付状態取得

dc_mcf_tlsln

CBLDCMCF('TLSLN△△△')

○

○

サーバ型コネクションの確立要求の受付終了

dc_mcf_tofln

CBLDCMCF('TOFLN△△△')

○

○

サーバ型コネクションの確立要求の受付開始

dc_mcf_tonln

CBLDCMCF('TONLN△△△')

○

○

注※

上段がC言語の関数，下段がCOBOL-UAP作成用プログラムです。TP1/Messagingでは，DMLは使えません。

付録A.5　TP1/MessagingとMCFの仕様差異

TP1/MessagingとMCFの仕様差異を，次に示します。

表A‒12　TP1/MessagingとMCFの仕様差異（指定値の差異）

定義

コマンド

オプション

オペランド

指定値

TP1/Messaging

MCF

MCFマネジャ定義

mcfmcomn

-p

−

((100〜2000000))

((100〜1945599))

mcfmuap

-e

segsize

((512〜2147483647))

《512※》

((512〜2147483647))

《32768》

-c

noansreply

yes｜《no※》

《yes》｜no

MCF通信構成定義共通部

mcftenv

-s

−

((01〜ee))

（アプリケーション起動プロセス識別子の場合：ef）

((01〜ef))

mcfttred

-m

−

((1〜10))《10》

((1〜1000))《10》

MCFアプリケーション定義

mcfaenv

-p

−

ef

((01〜ef))

mcfaalcap

-n

type

ans｜《noans》

ans｜《noans》｜cont

MCF通信構成定義TCP/IP固有部

mcftalccn

-u

masm

《yes》｜no

yes｜《no》

delichk

dccm2m｜dccm2s｜dccm3m｜dccm3s｜《nouse》

dccm2m｜dccm2s｜dccm3m｜dccm3s｜use｜《nouse》

システムサービス共通情報定義

−

−

max_open_fds

〈符号なし整数〉

((100〜4032))

〈符号なし整数〉

((500〜4032))

注※

07-51より前のバージョンでのデフォルト値と同じ値です。

表A‒13　TP1/MessagingとMCFの仕様差異(指定数の差異)

定義

コマンド

指定数

TP1/Messaging

MCF

MCFアプリケーション定義

mcfaalcap

1〜64または1〜8192※1

1〜8192

MCF通信構成定義TCP/IP固有部

mcftalccn

1〜16または1〜300※2

1〜2048

mcftalcle

1〜16または1〜300※2

1〜2048

注※1

TP1/Messaging - Extension 1をインストールしていない場合：1〜64

TP1/Messaging - Extension 1をインストールしている場合：1〜8192

注※2

TP1/Messaging - Extension 1をインストールしていない場合：1〜16

TP1/Messaging - Extension 1をインストールしている場合：1〜300

付録B　バージョンアップ時の変更点

バージョンアップ時の変更点について説明します。

付録B.1　07-51での変更点

TP1/Messaging 07-51での関数，定義，およびコマンドの追加と削除を次の表に示します。

表B‒1　TP1/Messaging 07-51での関数，定義，およびコマンドの追加と削除

種類

分類

内容

追加

関数

dc_mcf_adltap※¹

dc_mcf_ap_info※¹

dc_mcf_reply※¹

dc_mcf_sendsync※¹

dc_mcf_tactcn※¹

dc_mcf_tactle※¹

dc_mcf_tdctcn※¹

dc_mcf_tdctle※¹

dc_mcf_tdlqle※¹

dc_mcf_tlscn※¹

dc_mcf_tlscom※¹

dc_mcf_tlsle※¹

dc_mcf_tlsln※¹

dc_mcf_tofln※¹

dc_mcf_tonln※¹

CBLDCMCF('ADLTAP△△')※¹

CBLDCMCF('APINFO△△')※¹

CBLDCMCF('REPLY△△△')※¹

CBLDCMCF('SENDSYNC')※¹

CBLDCMCF('TACTCN△△')※¹

CBLDCMCF('TACTLE△△')※¹

CBLDCMCF('TDCTCN△△')※¹

CBLDCMCF('TDCTLE△△')※¹

CBLDCMCF('TDLQLE△△')※¹

CBLDCMCF('TLSCN△△△')※¹

CBLDCMCF('TLSCOM△△')※¹

CBLDCMCF('TLSLE△△△')※¹

CBLDCMCF('TLSLN△△△')※¹

CBLDCMCF('TOFLN△△△')※¹

CBLDCMCF('TONLN△△△')※¹

定義

MCFマネジャ定義

mcfmuap定義コマンドの-cオプション

noansreplyオペランド※¹

otqinholdオペランド

mcfmuap定義コマンドの-rオプション

reschedulecntオペランド※¹

rescheduleintオペランド※¹

reschedulelogオペランド※¹

mcfmsmsg定義コマンドの-mオプション※¹

mcfmsvg定義コマンドの-gオプション

servgrpnオペランド※¹

mcfmsvg定義コマンドの-wオプション

watchcntオペランド※¹

watchintオペランド※¹

expectcntオペランド※¹

abortオペランド※¹

MCFアプリケーション定義

mcfaalcap定義コマンドの-nオプション

errevtオペランド※¹

replychkオペランド※¹

mcfaalcap定義コマンドの-Nオプション

modelnameオペランド※¹

mcfaalcap定義コマンドの-dオプション

reschedulecntオペランド※¹

rescheduleintオペランド※¹

reschedulelogオペランド※¹

mcfaalcap定義コマンドの-eオプション

evtlogoutオペランド※¹

MCF通信構成定義

mcfttim定義コマンドの-pオプション

usertimeオペランド

timereqnoオペランド

msgsizeオペランド

msgoutオペランド

mcftalccn定義コマンドの-Nオプション

modelnameオペランド※¹

mcftalccn定義コマンドの-wオプション

srtimoutオペランド

mcftalccn定義コマンドの-kオプション

nodelayオペランド※¹

notrftimeオペランド※¹

mcftalccn定義コマンドの-fオプション

cnreleaseオペランド※¹

releaselogオペランド

cnerrlogオペランド

mcftalccn定義コマンドの-Aオプション

mastercnオペランド※2

mcftalccn定義コマンドの-uオプション

delichkオペランド※¹

mcftalccn定義コマンドの-hオプション

addrchkオペランド※¹

listenオペランド※¹

mcftalccn定義コマンドの-lオプション

cnassignオペランド※¹

mcftalcle定義コマンドの-Nオプション

modelnameオペランド※¹

mcftalcle定義コマンドの-dオプション

replacemsgオペランド

ユーザサービス定義

serviceオペランド

システムサービス共通情報定義

max_socket_descriptorsオペランド※¹

max_open_fdsオペランド※¹

mcf_prf_trace_levelオペランド

mcf_start_watch_intervalオペランド※¹

MCF性能検証用トレース定義

prf_file_sizeオペランド

prf_file_countオペランド

リアルタイム取得項目定義

rts_mcf_ap_scd_stayオペランド※¹

rts_mcf_ap_usr_srvcオペランド※¹

rts_mcf_in_msg_scd_waitオペランド※¹

rts_mcf_out_msg_sync_scd_waitオペランド※¹

rts_mcf_out_msg_resp_scd_waitオペランド※¹

rts_mcf_out_msg_prio_scd_waitオペランド※¹

rts_mcf_out_msg_norm_scd_waitオペランド※¹

rts_mcf_que_scd_wait_numオペランド※¹

コマンド

mcftchcnコマンド※2

mcftlslnコマンド※¹

mcftonlnコマンド※¹

mcftoflnコマンド※¹

mcftlstrdコマンド※¹

mcfalstapコマンド※¹

mcftlsutmコマンド※¹

注※1

この変更は，TP1/Messaging - Extension 1が必要です。

注※2

この変更は，TP1/NET/High Availabilityが必要です。

TP1/Messaging 07-51での動作の変更点を次に示します。

表B‒2　TP1/Messaging 07-51での動作の変更

分類

内容

定義

mcfaalcap定義コマンドの指定数の上限を64から8192に変更※

mcftalccn定義コマンドの指定数の上限を16から300に変更※

mcftalcle定義コマンドの指定数の上限を16から300に変更※

次のオペランドにansを指定できるように変更※

MCFアプリケーション定義

mcfaalcap定義コマンドの-nオプション

typeオペランド

次のオプションにrequestを指定できるように変更※

アプリケーション起動環境定義

mcftalcle定義コマンドの-tオプション

メッセージ

KFCA10365-I

出力情報に最大未送信メッセージ数の情報を追加

KFCA10366-I

出力情報に最大バッファ使用数の情報を追加

KFCA10505-I，KFCA10509-I

出力情報に-mオプションと-rオプションを追加

KFCA01892-I

出力情報に保守情報8，9の情報を追加

その他

MCFダンプファイルの出力上限数を99から3に変更

出力キューのメッセージ最大格納数を無制限から65535に変更

サーバ型コネクションのアドレス割り当てに失敗した場合，MCF通信プロセスの起動を中断しないように変更

サーバ型コネクションで受付処理の再試行回数が上限(bretrycntオペランドの指定値)を超えた場合，次のように対処する。

TP1/Messaging - Extension 1をインストールしていない場合：TP1/Messagingを再起動する。

TP1/Messaging - Extension 1をインストールしている場合：運用コマンド（mcftonln）を入力するか，またはAPI（dc_mcf_tonln関数もしくはCBLDCMCF('TONLN△△△')）を発行し，コネクションの確立要求の受付を開始する。

注※

この変更は，TP1/Messaging - Extension 1が必要です。

TP1/Messaging 07-51でのデフォルト値の変更点を次の表に示します。

表B‒3　TP1/Messaging 07-51でのデフォルト値の変更

分類

内容

定義

MCFマネジャ定義

mcfmuap定義コマンドの-cオプションのorderオペランドのデフォルト値（function）をcommitに変更

付録B.2　07-00での変更点

TP1/Messaging 07-00での変更点を次の表に示します。

表B‒4　TP1/Messaging 07-00での変更

種別

分類

内容

追加

GUI

TCP/IPコネクション属性設定画面に［コネクションリプレースの使用］オプションボタンを追加

定義

MCFマネジャ定義のmcfmuap定義コマンドの-cオプションのorderオペランドを追加

MCF通信構成定義のmcfttrc定義コマンドの-tオプションのmsgsizeオペランドを追加

MCF通信構成定義mcftalccn定義コマンドの-hオプションのchgconnオペランドを追加

変更

GUI

アプリケーション属性設定画面の［アプリケーションの型］オプションボタンの応答型を非活性に変更

アプリケーション間通信環境設定画面の［端末タイプ］オプションボタンの問い合わせ応答型を非活性に変更

TCP/IPコネクション属性設定画面の［ポート番号］の指定範囲（1024〜65525）を1〜65535に変更

MHP環境設定画面の［プログラム名］の指定範囲（1〜8）を1〜14に変更

MHP環境設定画面の［サービス滞留件数］の指定範囲（1〜512）を0〜512に変更

定義

MCF通信構成定義mcftalccnの-oオプションのoportnoオペランドの指定範囲（1024〜65535）を1〜65535に変更

MCFアプリケーション定義mcfaalcapの-nオプションのtypeオペランドの指定値をnoansだけに変更

廃止

定義

MCF通信構成定義mcftalccnの-bオプションのdretryオペランド，dretrycntオペランド，およびdretryintオペランドを廃止

MCFマネジャ定義mcfmcomnの-iオプションを廃止

TP1/Messaging 07-00でのデフォルト動作の変更点を次の表に示します。

表B‒5　TP1/Messaging 07-00でのデフォルト動作の変更

分類

内容

定義

MCF通信構成定義mcfttimの-tオプションのbtimオペランドのデフォルト値（5秒）を1秒に変更

MCF通信構成定義mcfttrcの-tオプションのsizeオペランドのデフォルト値（20480バイト）を204800バイトに変更

MCF通信構成定義mcfttrcの-tオプションのdiskオペランドのデフォルト値（no）をyesに変更

その他

定義テキストファイルのバックアップファイルを取得するように仕様を変更

付録C　サンプルプログラム

TP1/Messagingでは，UAPのサンプルプログラムを用意しています。サンプルプログラムを使用すると，コーディング時の負荷を減らせます。

TP1/Messagingのサンプルプログラムが格納されているディレクトリを次に示します。

C:¥OpenTP1は，OpenTP1のホームディレクトリ（%DCDIR%）です。この値は，セットアップ時に仮定されている初期値です。

ディレクトリと，格納されているプログラムの内容を次に示します。

C¥：C言語でコーディングしたアプリケーション（MHP）

COBOL¥：COBOL言語でコーディングしたアプリケーション（MHP）

CONF¥：サンプルプログラムの実行環境を設定したファイル

TCPIP¥：TCP/IP通信機能でコーディングしたアプリケーション（SUP,SPP,MHP）

付録D　用語解説

（英字）

GUI

グラフィカルユーザインタフェースといい，画面に表示された絵をクリックすることで，環境設定や運用を行う操作方法です。Windowsシステムでは，この方法によって，複雑な文法規則を意識しないで操作ができます。

MCF

OpenTP1システムのメッセージ制御機能です。メッセージの送受信に必要なコネクションおよび論理端末について，設定や管理を行います。

MHP

OpenTP1システムで使用するユーザアプリケーションプログラムのうち，メッセージ送受信を制御するためのプログラムです。TP1/Messagingでは，ユーザのアプリケーションとして，MHPを使用します。

TCP/IP

システム間で通信をする際の通信規約（プロトコル）の一つです。OSIで規定している7層構造のうち，主に第4層と第3層の通信規約について定めています。

（ア行）

アプリケーション

TP1/Messagingでユーザが使用する業務プログラムです。TP1/Messagingで使用できるのは，MHPです。OpenTP1システムでユーザアプリケーションプログラム（UAP）と呼んでいる，プログラムの中の一つを指します。

（カ行）

コネクション

OpenTP1でメッセージ送受信をする場合に，自システムと相手システムとの間に確立する論理的な通信路です。TP1/MessagingでTCP/IPプロトコルを使用して通信をする場合にも，コネクションを確立する必要があります。

コマンドプロンプト

システムの環境設定や運用をする場合に，キーボードからコマンドの文字列を入力し，対話形式で行う画面のことです。UNIXシステムの場合は，この画面で操作します。Windowsシステムの場合は，GUIで操作します。

（サ行）

サーチパス

システム内で，アプリケーションがどのディレクトリにあるかを示す機能です。この機能を使用すると，目的のアプリケーションがどのようなディレクトリを通って格納されているかが確認できます。

索引

数字

07-00での変更点[1]

07-51での変更点[1]

G

GUI[1]、[2]

GUIによる環境設定[1]

GUIの画面からのオペレーション（MCF）[1]

GUIの画面からのオペレーション（MHP）[1]

I

［IPアドレス指定］テキストボックス[1]

M

MCF[1]

MCFアプリケーションの環境設定[1]

MCFアプリケーション名[1]

MCFイベントトレースファイル[1]

MCFオペレーションGUI[1]

MCF環境設定[1]

MCF環境設定GUI[1]

MCF環境設定時の画面構成[1]

MCF環境設定で生成される定義オブジェクトファイル一覧[1]

MCF環境設定で生成される定義テキストファイル一覧[1]

MCFダンプファイル[1]

MCF通信サービスとアプリケーションの対応づけ[1]

MCFのオペレーション[1]

MCFのオペレーションの終了[1]

MHP[1]

MHP一覧表示部[1]

MHP環境設定[1]、[2]、[3]

MHP環境設定GUI[1]

MHP環境設定画面で設定する項目[1]

MHP管理[1]

MHP状態表示部[1]、[2]

MHPのオペレーション[1]

MHPのオペレーションの終了[1]

MHPユーザサーバおよびサービスグループの状態表示[1]

MHPユーザサーバの管理[1]

MHPユーザサーバの起動[1]、[2]

MHPユーザサーバの強制停止[1]

MHPユーザサーバの停止[1]

T

TCP/IP[1]

TCP/IPコネクション属性設定[1]

TCP/IP通信環境設定欄[1]

TCP/IP通信サービス環境設定[1]

TCP/IP通信サービス環境設定画面で設定する項目[1]

［TCP/IP通信サービス名（S）］テキストボックス[1]

［TCP/IP通信サービス名（T）］リストボックス[1]

TP1/LiNK起動[1]

TP1/Messaging[1]

TP1/MessagingとMCFの運用コマンドの差異[1]

TP1/MessagingとMCFの関数の差異[1]

TP1/MessagingとMCFの機能の差異[1]

TP1/MessagingとMCFの差異[1]

TP1/MessagingとMCFの仕様差異[1]

TP1/MessagingとMCFの定義の差異[1]

TP1/Messagingの概要[1]

TP1/Messagingの環境設定項目[1]

TP1/Messagingの起動と停止[1]

TP1/Messagingの機能[1]

TP1/Messagingのトラブル[1]

TP1/Messaging - Extension 1[1]

U

UOC[1]

あ

相手システム属性欄[1]

［値（Z）］テキストボックス[1]

アプリケーション[1]

［アプリケーション（A）］ボタン[1]

アプリケーション間通信環境設定[1]

アプリケーション間通信環境設定欄[1]

［アプリケーション間通信サービス識別子（I）］テキストボックス[1]

［アプリケーション間通信サービス名（P）］リストボックス[1]

［アプリケーション間通信サービス名（S）］テキストボックス[1]

アプリケーショングループ環境設定[1]

アプリケーショングループ環境設定欄[1]

［アプリケーショングループ名（G）］テキストボックス[1]、[2]、[3]

［アプリケーショングループ名（G）］リストボックス[1]

アプリケーション属性設定[1]

アプリケーション属性設定欄[1]

［アプリケーションの型］オプションボタン[1]

アプリケーションの管理[1]

［アプリケーションの種別］オプションボタン[1]

アプリケーションの準備[1]

アプリケーションの状態表示[1]

アプリケーションの閉塞[1]

アプリケーションの閉塞解除[1]

アプリケーション名[1]

［アプリケーション名（A）］テキストボックス[1]、[2]

［アプリケーション名（P）］リストボックス[1]

え

［エントリポイント名（E）］テキストボックス[1]

お

オペレーション[1]

か

開始画面で設定する項目[1]

［確立モード］オプションボタン[1]

環境設定[1]

環境設定終了時の表示画面[1]

環境設定の手順[1]

環境設定をする前に[1]

き

起動[1]

［起動（S）］ボタン[1]

強制停止[1]

［強制停止（O）］ボタン[1]

共用メモリ[1]

共用メモリ算出用定義ソースファイルの編集による環境設定[1]

く

［グローバル］リストボックス[1]

こ

コアダンプファイル[1]

コーディング[1]

コネクション[1]

コネクションおよび論理端末の管理[1]

コネクションおよび論理端末の状態表示[1]

コネクション状態[1]

コネクション属性欄[1]

コネクションの解放[1]

［コネクションの解放（D）］ボタン[1]

コネクションの確立[1]

［コネクションの確立（A）］ボタン[1]

［コネクションの自動確立］オプションボタン[1]

コネクション名[1]

［コネクション名（N）］テキストボックス[1]

［コネクション名（N）］リストボックス[1]

［コネクションリプレースの使用］オプションボタン[1]

［コネクション・論理端末（C）］ボタン[1]

コマンドプロンプト[1]

コマンドプロンプト画面からのオペレーション（MCF）[1]

コマンドプロンプト画面からのオペレーション（MHP）[1]

コンパイルとリンケージ[1]

さ

サーチパス[1]

サーチパス状態[1]

サーチパスのオペレーションの終了[1]

サーチパスの削除[1]

サーチパスの参照[1]

サーチパスの設定[1]

［サーバ定義（E）］ボタン[1]、[2]

サービスグループの閉塞[1]

サービスグループの閉塞解除[1]

サービスグループ名[1]、[2]、[3]

［サービスグループ名（G）］テキストボックス[1]、[2]

［サービス詳細（A）］ボタン[1]

サービス状態表示部[1]

［サービス滞留件数（Q）］ボックス[1]

サービスのオペレーションの終了[1]

サービスの管理[1]

サービスの状態の表示[1]

サービスの閉塞[1]

サービスの閉塞解除[1]

［サービス閉塞（D）］ボタン[1]

［サービス閉塞解除（A）］ボタン[1]

サービス名[1]、[2]

［サービス名（S）］テキストボックス[1]、[2]

［最新情報（N）］ボタン[1]

［最新情報に更新（L）］ボタン[1]

［最新の状態（N）］ボタン[1]

［最新の情報（N）］ボタン[1]

作業の流れ[1]

サンプルプログラム[1]

サンプルプログラムが格納されているディレクトリ[1]

し

識別子[1]、[2]

資源自動見積もり機能[1]

自システム属性欄[1]

実行環境の設定[1]

実行形式ファイル名[1]

［実行形式プログラム名（E）］テキストボックス[1]、[2]

［自動起動あり］リストボックス[1]

自動起動設定[1]

［自動起動設定（A）］ボタン[1]、[2]

［自動起動なし］リストボックス[1]

種別[1]

［詳細設定（T）］ボタン[1]

状態[1]

状態表示欄[1]、[2]

常駐[1]

［常駐（R）］ボックス[1]

初期設定ファイルの格納フォルダ[1]

［初期値設定（I）］ボタン[1]

す

［スケジュール（H）］ボックス[1]

スケジュール状態[1]

スケジュール情報欄[1]

スタブソースファイル[1]

ステータスファイル[1]

た

［端末タイプ］オプションボタン[1]

つ

［追加（A）］ボタン[1]

［通信サービス識別子（I）］テキストボックス[1]

て

定義オブジェクトファイル一覧[1]

定義ソースファイル編集による環境設定[1]

定義テキストファイルのバックアップファイルの格納フォルダ[1]

定義変換コマンド一覧[1]

停止[1]

［停止（T）］ボタン[1]

と

登録するサービス欄[1]

［登録するサービス］リストボックス[1]

トラブルが発生したら[1]

トラブルシュート情報[1]

トラブルの種類と原因[1]

［トランザクション機能（T）］チェックボックス[1]、[2]

な

［内部通信路名（P）］テキストボックス[1]

に

入力状態[1]

［任意のポート番号］オプションボタン[1]

は

バージョンアップ時の変更点[1]

バージョン情報の表示[1]、[2]、[3]

ひ

非常駐[1]

［非常駐（N）］ボックス[1]

ふ

プログラムのサーチパス[1]

［プログラムのサーチパス（P）］ボタン[1]

［プログラム名（P）］テキストボックス[1]

［プロセス（M）］ボックス[1]

プロセス数欄[1]

へ

［閉塞（D）］ボタン[1]、[2]

［閉塞解除（A）］ボタン[1]

［閉塞解除（R）］ボタン[1]

変更サーチパス名[1]

［変数（Y）］テキストボックス[1]

ほ

［ポート番号Free］オプションボタン[1]

［ポート番号］オプションボタン[1]、[2]

［ホスト名称設定］テキストボックス[1]

め

メッセージ[1]

メッセージ出力欄[1]、[2]

メニューバー[1]、[2]、[3]、[4]

ゆ

ユーザサーバ状態[1]

ユーザサーバの環境変数欄[1]

ユーザサーバ名[1]

［ユーザサーバ名（U）］テキストボックス[1]

［ユーザメッセージ長］オプションボタン[1]

優先順位欄[1]

よ

用語解説[1]

ろ

［ローカル］リストボックス[1]

論理端末状態[1]

論理端末属性欄[1]

論理端末の閉塞[1]

［論理端末の閉塞（F）］ボタン[1]

論理端末の閉塞解除[1]

［論理端末の閉塞解除（S）］ボタン[1]

論理端末名[1]

［論理端末名（L）］テキストボックス[1]

［論理端末名（L）］リストボックス[1]