JP1 Version 11　JP1/File Transmission Server/FTP（Windows(R)用）

解説・文法・操作書

3021-3-B36

前書き

対象製品

P-2A41-94BL JP1/File Transmission Server/FTP 11-00（適用OS：Windows Server 2008，Windows Server 2012）

輸出時の注意

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

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

商標類

HITACHI，JP1は，（株）日立製作所の商標または登録商標です。

Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

MSDNは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

Visual C++は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Visual Studioは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Win32は，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by IAIK of Graz University of Technology.

This software and documentation is based in part on BSD Networking Software, Release 1 licensed from The Regents of the University of California. We acknowledge the role of the Computer Systems Research Group and the Electrical Engineering and Computer Sciences Department of the University of California at Berkeley in its development.

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

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

正式名称

MSDN

MSDN(R)

Visual C

Visual C++(R)

Visual Studio

Visual Studio(R)

Win32

Win32(R)

Windows

Windows Server 2008

Windows Server 2008 R2

Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Microsoft(R) Windows Server(R) 2008 R2 Enterprise

Microsoft(R) Windows Server(R) 2008 R2 Standard

Windows Server 2012

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Standard

発行

2016年 1月 3021-3-B36

著作権

All Rights Reserved. Copyright (C) 2016, Hitachi, Ltd.

はじめに

このマニュアルは，JP1/File Transmission Server/FTP（以降，JP1/FTPと省略します）の機能と操作方法について説明したものです。

対象読者

このマニュアルは，JP1/FTPを使用してファイル伝送するシステムのシステム管理者，および運用や保守をするシステム運用者を対象にしています。また，次の内容を理解されていることを前提としています。

Windowsに関する知識

TCP/IPに関する知識

FTPプロトコルに関する知識

1　JP1/FTPの概要

JP1/FTPは，LANおよびWAN環境でファイルを伝送するためのプログラムです。この章では，JP1/FTPの特長と機能を説明します。また，例題を使って操作の流れを紹介します。

1.1　特長

JP1/FTPは，運用管理機能を備えたファイル伝送プログラムです。ファイル伝送の標準的なプロトコルのFTP手順を使用しています。OS標準のFTP機能に比べ，定型業務でファイル伝送をする場合に有効な機能を持っています。

ファイル伝送業務を自動化

ジョブ起動機能を利用して，ファイル伝送後の処理を自動化できます。

API機能を使用して，ユーザアプリケーションからファイルを送受信できます。

1日数回，基幹サーバからデータを受信し，集計といった処理などを自動化できます。

実行状況の管理

ファイル伝送状態の表示と通知を利用して，障害処理などの対応処理ができます。

ファイル送受信時の履歴情報の採取と表示によって，伝送状態を管理できます。

スケジュール伝送

JP1/AJS3と連携することによって，定型業務のスケジュール伝送が容易にできます。また，JP1/FTPのジョブ自動起動で，ファイル送受信後の業務を自動化できます。

JP1/IMでの集中監視

JP1/IMを利用することによって，サービスの開始，停止，伝送の終了（正常，警告，異常）を，JP1/IMで集中監視ができます。

運用管理機能

ネットワーク上に分散する複数のJP1/FTPホストの，ファイル伝送業務の履歴表示や，各種定義情報の配布，設定などができます。

1.2　機能

JP1/FTPを使用したファイル伝送の例を，次の図に示します。

図1‒1　ファイル伝送の例（横浜支社から東京本社へファイルを伝送する）

JP1/FTPを使って，別のホストにファイルを送信，受信することを「伝送」といいます。また，ファイルを伝送する側を「クライアント」といい，伝送される側を「サーバ」といいます。1台にクライアント，サーバの両方の役割を与えることもできます。

JP1/FTPには，次の3つの機能があります。

ファイル伝送機能

運用管理機能

JP1プログラムとの連携機能

それぞれの機能の特長を次に示します。

1.2.1　ファイル伝送機能

(1)　伝送情報を伝送カードに登録して伝送できます

伝送する情報を「伝送カード」に登録します。複数の伝送カードを指定して，一度に伝送できます。また，登録済みの伝送カードをひな形として，内容を一部書き換えて伝送することもできます。

また，次のような伝送ができます。

複数のファイルの一括伝送

ワイルドカードを使って，複数のファイルを伝送対象に指定できます。毎週複数部署の業務報告ファイルを伝送する場合などは，ファイル名称に付与規則を設け，統一しておくことで，効率良く伝送ができます。

伝送時のファイルサイズ確認

送信側と受信側で伝送されたファイルのサイズが，正しいかどうかを確認できます。通常，伝送が正常終了していれば，ファイルが伝送中に破損していても気づきませんが，ファイルサイズ確認では，ファイルサイズが変わっていた場合は，伝送エラーになります。これによって，信頼性のある伝送ができます。

ファイルサイズの確認は，JP1/FTP同士またはuCosminexus Service Platformとの伝送時だけ有効です。

(2)　ファイルを伝送後，プログラムを自動で起動できます

ファイル伝送後，指定したプログラムを自動で起動でき，作業の自動化が図れます。プログラムを起動させる契機は，次のような指定ができます。

特定のユーザからのファイル伝送を契機に，特定のプログラムを起動させる

特定のファイルのファイル伝送を契機に，特定のプログラムを起動させる

(3)　ファイル伝送履歴を確認できます

サーバ，クライアントどちらからでも伝送履歴が確認できます。伝送履歴の参照や，異常終了した伝送のエラーの確認などができます。また，履歴一覧に表示する内容は，異常終了の履歴だけを表示するなど，目的に応じた表示ができます。

(4)　APIでユーザプログラムと連携できます

APIを利用して，ユーザプログラムと連携したファイル伝送ができます。使用している環境に合わせた伝送と，伝送後の作業の自動化が図れます。

(5)　定義情報の保存・復元ができます

JP1/FTPの各定義情報は，保存し，別のホストに配布して配布先で復元できます。あるホストで保存した定義情報を，複数のホストで復元することで，設定を簡略化できます。

1.2.2　運用管理機能

ネットワーク上に分散するJP1/FTPのホストの，履歴の参照や，定義情報の確認が1つのホストからでき，システム管理者の負担を軽減できます。

1.2.3　JP1プログラムとの連携機能

(1)　JP1/AJS3と連携して，スケジュール伝送ができます

JP1/AJS3と連携して，伝送を契機にジョブを実行できます。これによって，一連の業務を自動化できます。

(2)　JP1/IMと連携して，伝送結果を確認できます

JP1/IMと連携して，JP1/FTPのサービスの状況，ファイル伝送の結果を確認できます。通常はJP1/IMから監視し，エラーが表示されたときなどに，JP1/FTPの履歴で詳細を確認するなど，使い分けができます。

1.3　JP1/FTPの操作の流れ

JP1/FTPは，［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［各機能のメニュー］を選択し，各機能を起動します。

JP1/FTPのファイル伝送の流れを，業務例に沿って紹介します。

図1‒2　業務例

1.3.1　JP1/FTPの定義情報の登録

次の定義情報を登録します。

環境定義情報

伝送実行情報（ログインユーザ情報，自動起動プログラム情報，伝送情報）

図1‒3　定義情報の登録例

情報の種類

操作概要

実行するホスト

実行するメニュー

（参照先）

環境定義情報

環境定義情報の定義

伝送時のバッファサイズ，履歴ファイルのサイズなど，JP1/FTPの環境を定義します。

サーバ/クライアント

［定義ユティリティ］

（「3.1 JP1/FTPの環境定義」）

伝送実行情報

ログインユーザ情報の登録

ファイル伝送時に，サーバにログインするユーザを登録します。

上記例では，東京本社のサーバに横浜支社からログインするユーザ（eigyou）を登録します。

サーバ

［ログインユーザの登録］

（「3.2 ログインユーザの登録」）

自動起動プログラム情報の登録

サーバにファイルが伝送されたあと，サーバ側で自動的に起動するプログラムを登録します。

上記例では，東京本社のサーバに「eigyouから営業報告ファイルを受信したら，集計プログラムを起動する」という登録をします。

サーバ

［自動起動プログラムの登録］

（「3.3 自動起動プログラムの登録」）

伝送情報の登録

ファイル伝送をする内容（相手サーバ，伝送ファイル名など）を伝送カードに登録します。伝送情報の登録は，コマンドでもできます。

上記例では，横浜支社から東京本社へファイル伝送をする情報を登録します。

クライアント

［伝送の登録／実行］

（「3.4 伝送情報の登録」）

1.3.2　伝送の実行

伝送情報を「伝送カード」に登録し，伝送を実行します。伝送の結果は，履歴で確認します。

図1‒4　伝送の実行例

操作概要

実行するホスト

実行するメニュー（参照先）

伝送の実行

登録した伝送カードを指定して，伝送を実行します。伝送の実行はコマンドでもできます。

上記例では，横浜支社から東京本社へファイル伝送を実行します。

クライアント

［伝送の登録／実行］

（「3.5 ファイル伝送」）

履歴の表示

ファイル伝送の結果を履歴表示で確認します。

上記例では，東京本社では受信履歴が，横浜支社では送信履歴が確認できます。

サーバ/クライアント

［履歴情報の表示］

（「3.6 伝送履歴の確認」）

1.3.3　定義情報の保存・復元

JP1/FTPの定義情報は，保存・復元，またはテキスト出力ができます。

図1‒5　定義情報の保存・復元例

操作概要

実行するホスト

実行するメニュー（参照先）

定義情報の保存・復元

あるホストで作成した定義情報を保存し，ほかのホストで復元できます。

保存・復元できる定義情報

環境情報

ログインユーザ情報

自動起動プログラム情報

伝送情報

上記例では，横浜支社の定義情報を，大阪，福岡支社で復元しています。このように環境を容易に整えることができます。

情報が登録されているサーバ/クライアント

［定義情報の保存・復元］

（「3.7 定義情報の保存・復元」）

定義情報のテキスト出力

登録した情報を，テキストに出力できます。出力するフォーマットは，サンプルが用意されています。

テキスト出力できる定義情報

ログインユーザ情報

自動起動プログラム情報

伝送情報

履歴情報

情報が登録されているサーバ/クライアント

［（各情報を登録するメニュー）］

（「3.8 定義情報のテキスト出力」）

1.3.4　他ホストのJP1/FTPの定義情報の確認

運用管理コンソールを使って，ほかのJP1/FTPの定義情報の確認と変更，履歴の参照ができます。

図1‒6　他ホストのJP1/FTPの定義情報の確認例

操作概要

実行するホスト

実行するメニュー（参照先）

運用管理コンソール

他ホストの定義情報の確認と登録，変更，削除，履歴情報の参照ができます。

定義情報を確認する側を，「運用管理コンソール」，確認される側を「運用管理エージェント」といいます。

上記例では，東京本社から各支社の履歴の参照，定義情報の確認ができます。

運用管理コンソール

［運用管理コンソール］

（「4. JP1/FTPの運用管理」）

2　インストールとセットアップ

この章では，JP1/FTPをお使いになるまでに必要な作業と設定について説明します。

2.1　JP1/FTPのシステム構成

JP1/FTPのシステム構成を説明します。

2.1.1　前提OS

次に示すOSのうち，どれか1つを使用します。

Windows Server 2008 R2

Windows Server 2012

Windows Server 2012 R2

2.1.2　基本のシステム構成

クライアント，サーバ共にJP1/FTPをインストールし，ファイル伝送をするシステムです。クライアントからサーバへファイル伝送を実行します。

どちらのマシンに，サーバ，クライアントのどちらの機能を持たせるかは，JP1/FTPのインストール後，サービスの起動で設定します。1台のマシンに，クライアント，サーバ両方のサービスを起動させることもできます。サービスの起動については，「2.3 サービスの起動・終了」を参照してください。

図2‒1　JP1/FTPでファイル伝送をする基本のシステム構成例

2.2　インストールとセットアップ

JP1/FTPのインストールとセットアップ方法を説明します。

2.2.1　JP1/FTPをインストールする

JP1/NETM/DMは，日本国内の製品名称です。

提供媒体を使用してインストール，またはJP1/NETM/DMを使用して，JP1/FTPをリモートインストールしてください。

提供媒体を使用してインストールする手順を説明します。

JP1/FTPをインストールするマシンに，管理者でログインする。

次のプログラムを終了する。

JP1/FTPのプログラム（サービス，GUIなど）

Windowsのイベントビューア

Windowsのサービス画面

プログラムが起動したままの場合，JP1/FTPのインストールに失敗するおそれがあります。

サービスの終了方法については，「2.3　サービスの起動・終了」を参照してください。

提供媒体をセットする。

インストーラーが起動します。インストーラーの指示に従ってインストールを進めてください。

インストール時には，次の情報を定義します。

ユーザ情報

ユーザ名，会社名を入力します。

インストール先

JP1/FTPをインストールするディレクトリを指定します。

デフォルトは次のとおりです。

製品本体：

　OSのインストールドライブ:¥Program Files(x86)¥Hitachi¥FTSFTP

64ビット用APIライブラリ：

　OSのインストールドライブ:¥Program Files¥Hitachi¥FTSFTP

注意事項

製品本体を「OSのインストールドライブ：¥Program Files」の配下にはインストールしないでください。64ビットモジュールと混在することによって，動作上問題が発生することがあります。

2.2.2　言語種別を設定する

JP1/FTPは，日本語および英語で動作します。

言語種別を設定する手順を次に示します。

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［Language Selection］を選択する。

使用する言語を選択するダイアログボックスが表示されます。

プルダウンメニューから，日本語（Japanese）または英語（English）を選択し，［OK］をクリックする。

注意事項

言語種別を設定するときは，JP1/FTPのプログラム（サービス，GUIなど）を終了してから設定してください。

2.2.3　ポート番号を設定する

JP1/FTPが使用するポート番号を次のファイルに設定します。

設定するファイル

OSのインストールディレクトリ¥system32¥drivers¥etc¥services

設定内容

ftssdata         aaaaa-1/tcp    #サーバでデータ伝送時に使用
ftss             aaaaa/tcp      #サーバ着信時に使用
ftsc             bbbbb/tcp      #クライアントで使用
ftsclog          ccccc/tcp      #クライアントでロギング取得用に使用
ftsslog          ddddd/tcp      #サーバでロギング取得用に使用
ftsagent         eeeee/tcp      #運用管理機能（エージェント）に使用

（凡例）

aaaaa，bbbbb，ccccc，ddddd，eeeee：それぞれほかのプログラムのポート番号と重複しない任意の番号を設定します。

「aaaaa-1」は，自動的に割り当てられますが，上記のように明示しておくことをお勧めします。

OS自動割り当て範囲のポート番号を指定すると，JP1/FTPまたはほかのプログラムの動作中にOSによって割り当てられ，重複する可能性があります。

サーバまたはクライアントとしてだけ使用する場合は，次の項目だけを設定します。

サーバとしてだけ使用する場合：ftssdata，ftss，ftsslog

クライアントとしてだけ使用する場合：ftsc，ftsclog

ポート番号の設定例

ftssdata      20124/tcp      #サーバでデータ伝送時に使用
ftss          20125/tcp      #サーバ着信時に使用
ftsc          20126/tcp      #クライアントで使用
ftsclog       20127/tcp      #クライアントでロギング取得用に使用
ftsslog       20128/tcp      #サーバでロギング取得用に使用
ftsagent      20252/tcp      #運用管理機能（エージェント）に使用

JP1/FTPのインストールディレクトリ¥services.sampleに，サンプルを用意しています。

伝送時の指定

JP1/FTPをサーバ側（着信側）で使用する場合，クライアント（発信側）は，ファイル伝送時に「ftss」に割り当てたポート番号（上記の設定例の場合は，20125）を指定します。

OS標準のFTPからJP1/FTPへファイル伝送をする場合

JP1/FTPをサーバ側，OS標準のFTPをクライアント側として，ファイル伝送をする場合は，次のようになります。

図2‒2　OS標準のFTPからJP1/FTPへファイル伝送をする場合の実行例

2.2.4　名称解決できる環境を構築する

JP1/FTPは，自ホストおよび相手ホストのホスト名解決（正引き），IPアドレス解決（逆引き）を行います。ホスト名解決，IPアドレス解決が一意に行えるOSの環境を構築してください。

2.2.5　JP1/FTPをアンインストールする

JP1/FTPをアンインストールする手順を次に示します。

次のプログラムを終了する。

JP1/FTPのプログラム（サービス，GUIなど）

Windowsのイベントビューア

Windowsのサービス画面

プログラムが起動したままの場合，JP1/FTPのアンインストールに失敗するおそれがあります。

サービスの終了方法については，「2.3　サービスの起動・終了」を参照してください。

Windowsの［スタート］メニューから，［コントロールパネル］−［プログラムと機能］を選択する。

アンインストールするプログラムを選択するダイアログボックスが表示されます。

［プログラムのアンインストールまたは変更］が選択されている状態で，現在インストールされているプログラムのリストから「JP1/File Transmission Server/FTP」を選択し，［アンインストール］ボタンをクリックする。

削除してもよいか確認するダイアログボックスが表示されます。

［はい］ボタンをクリックします。

プログラムがアンインストールされます。

2.3　サービスの起動・終了

JP1/FTPを使用するためには，サービスの起動が必要です。

2.3.1　サービスの種類

JP1/FTPを使用するには，使用する機能のサービスを起動させます。サービスの種類を次に示します。

JP1/File Transmission Server/FTP Server

サーバとして，ファイル伝送をするときに起動します。

JP1/File Transmission Server/FTP Client

クライアントとして，ファイル伝送をするときに起動します。

JP1/File Transmission Server/FTP Log

履歴情報を取得するときに起動します。

JP1/File Transmission Server/FTP Agent

運用管理機能を使用するとき起動します。

2.3.2　サービスを起動する

サービス起動時の注意事項

JP1/FTPのサービスは，サービスのログオン時に指定したアカウントで動作します。ファイルアクセスの権限なども，これに従います。

JP1/FTPのサービスは，同一のアカウントで起動してください。

JP1/FTPのサービスのアカウントを変更する場合，次に示すユーザーにだけ変更できます。それ以外のユーザーに変更すると，JP1/FTPの処理に影響を及ぼしたり，サービスが途中で停止したりするおそれがあります。

・ユーザアカウント制御（UAC）が有効の場合

　Administrator

・ユーザアカウント制御（UAC）が無効の場合

　Administrators権限を持つユーザー

使用するサービスを起動させます。サービスは，システムの起動時に自動的に起動するように設定することもできます。サービスを起動させる手順を次に示します。

Windowsの［スタート］メニューから，［コントロールパネル］−［管理ツール］−［サービス］を選択する。

［サービス］ダイアログボックスが表示されます。

起動するサービスを右クリックし，ポップアップメニューから［開始］を選択する。

サービスが起動します。サービスの起動時に，エラーが表示された場合は，イベントビューアに表示されるイベントログを参照してください。イベントログについては，「8.2 イベントビューアに表示されるメッセージ」を参照してください。

システム起動時に，自動的にサービスを起動させるには

起動するサービスの［プロパティ］ダイアログボックス（［全般］タブ）で，［スタートアップの種類］を［自動］にしておくと，システム起動時に，自動的にサービスが起動します。

2.3.3　サービスを終了する

サービスを終了する手順を次に示します。

Windowsの［スタート］メニューから，［コントロールパネル］−［管理ツール］−［サービス］を選択する。

［サービス］ダイアログボックスが表示されます。

停止するサービスを右クリックし，ポップアップメニューから［停止］を選択する。

サービスが停止します。伝送中のファイルがある場合は，伝送は強制的に停止され，異常終了になります。

3　JP1/FTPのファイル伝送

この章では，JP1/FTPのファイル伝送機能について，操作方法を説明します。

3.1　JP1/FTPの環境定義

JP1/FTPの環境定義をします。

環境定義はサーバ側，クライアント側それぞれで，［定義ユティリティ］を起動し，［環境定義］ダイアログボックスで定義します。

［環境定義］ダイアログボックスの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［定義ユティリティ］を選択します。

［環境定義］ダイアログボックスを次の図に示します。

図3‒1　［環境定義］ダイアログボックス

3.1.1　JP1/FTPの環境を定義する

インストール時にデフォルトの値が設定されます。必要な場合だけ変更してください。

［環境定義］ダイアログボックスの各項目の設定を変更し，［OK］をクリックする。

変更後は，すべてのサービスを再起動させます。

［環境定義］ダイアログボックスの各設定項目を次の表に示します。

表3‒1　［環境定義］ダイアログボックスの設定項目

項目

設定内容

履歴情報保存件数

((0〜100000件))

《2000件》

履歴情報を保存する件数を指定します。1ファイルの伝送が1件と数えられ，ファイル伝送の数が保存件数を超えた場合は，古い情報から上書きされます。

1件のサイズは1,500バイトで，「保存件数×1,500バイト」のファイルサイズを必要とします。

履歴情報保存件数を増やす場合

履歴情報保存件数を増やすと，履歴を表示するのに時間が掛かる場合があります。これはCPU，ハードディスクの性能や搭載メモリの量に依存します。履歴情報を長期間保存したい場合は，履歴情報ファイル（JP1/FTPのインストールディレクトリ¥history）をコピーして保存することをお勧めします。

標準値

環境定義の各値を，デフォルトの値に戻すときに，クリックします。

プロトコルトレースのファイルサイズ

((4〜3000KB))

《50KB》

ftpプロトコルのトレースを採取するファイルのサイズを指定します。プロトコルトレースファイルは，ftpレベルでのコマンドのやり取りを確認できます。トレース情報が指定サイズを超えた場合は，古い情報から上書きされます。

指定したサイズのファイルを120面必要とします。

トレースファイルは，メモ帳などのテキストエディターで参照できます。

モジュールトレースのファイルサイズ

((4〜3000KB))

《50KB》

モジュールトレースを採取するファイルのサイズを指定します。モジュールトレースは，保守情報として採取します。トレース情報が指定サイズを超えた場合は，古い情報から上書きされます。

指定したサイズのファイルを132面必要とします。

モジュールトレースファイルは，参照できません。

アクセスログのファイルサイズ

((0〜100MB))

《0MB》

アクセスログを保存するファイルのサイズを指定します。アクセスログ情報が指定サイズを超えた場合，古い情報をバックアップしてから新しくファイルを作成します。バックアップファイルがすでにある場合は，バックアップファイルを上書きします。

アクセスログファイルは，メモ帳などのテキストエディターで参照できます。

ホスト接続時のリトライ回数/間隔

ファイル伝送時のコネクション確立時，相手先ビジーなどによってコネクションを確立できなかったときのリトライ回数/間隔を指定します。リトライは，connectシステムコールが次のエラーコードの場合に実行します。

制御コネクション確立時

WSAECONNREFUSED（10061）

データコネクション確立時

WSAEADDRINUSE（10048）

ホスト接続時のリトライ回数((0〜100000回))《5回》

0を指定するとリトライしません。

ホスト接続時のリトライ間隔((0〜86400秒))《2秒》

0を指定すると間隔を置かないでリトライします。

TCP/IPウィンドウサイズ

((0〜65535Byte))

《32768Byte》

ソケットの送受信バッファサイズ（SO_SNDBUFおよびSO_RCVBUF）を指定します。0を指定すると，システムのデフォルト値が使用されます。

実際に伝送するときのウィンドウサイズではありません。

なお，伝送効率は，回線の速度や利用状況，CPUの性能等によって変動します。使用するシステムに合わせて，設定してください。

データ送信待ちタイムアウト

((1〜3600秒))

《60秒》

データ送信時に，パケットを送信し，送信バッファが空くまでの監視時間を指定します。指定した時間を経過してもバッファが空かないときは，伝送は異常終了します。

データ受信待ちタイムアウト

((1〜3600秒))

《60秒》

データ受信時に，パケットを受信する（伝送相手がパケットを送信してくる）までの監視時間を指定します。指定した時間を経過してもデータの受信がないときは，伝送は異常終了します。

サーバ（着信）/クライアント（発信）

送信/受信バッファのサイズ((512〜65535Byte))《4096Byte》

ファイル伝送（送信）するときのバッファ（メモリ）サイズをサーバ/クライアントでそれぞれ指定します。

この値は，メモリが制限されるとき，伝送効率を上げたいときなどに変更します。また，TCP/IPウィンドウサイズで指定した値未満を指定します。TCP/IPウィンドウサイズで指定した値以上を指定すると，伝送効率が悪くなります。なお，伝送効率は，回線の速度や利用状況，CPUの性能等によって変動します。使用するシステムに合わせて，設定してください。

「最大接続数×指定バッファサイズ」のメモリを伝送バッファとして確保します。送信と受信は同時には確保されません。また，伝送時にだけ確保します。

アイドルタイムアウト((30〜7200秒))《900秒》

一定時間，クライアントから要求がない場合に，サーバがクライアントへのコネクションを解放します。コネクションを解放するまでの時間を指定します。

履歴情報ディレクトリ

((2〜230バイトの文字列))

《JP1/FTPのインストールディレクトリ》

履歴情報ファイル（history）とトレース情報出力ディレクトリ（trace）を作成するディレクトリを指定します。なお，指定するディレクトリは，ローカルドライブだけ指定できます。

変更した場合，元のファイルとディレクトリはそのまま残ります。必要ない場合は削除してください。

JP1/IMイベントの発行

JP1イベントを発行するかどうかを選択します。チェックするとサービスの状態の変化時や，伝送の終了時にJP1イベントを発行します。JP1/IMと連携すると，JP1/IM上での状態監視ができるようになります。JP1/IMとの連携については，「5.2 JP1/IMとの連携」を参照してください。

デフォルトではチェックされていません。

伝送結果のNTイベントログ出力

ファイル伝送の結果（正常終了，異常終了）およびファイル伝送の開始をイベントログに出力するかどうかを選択します。

選択した場合，イベントID24〜27，33，および34が出力されます。イベントID24〜27，33，および34以外のイベントIDは，選択の有無にかかわらず，出力されます。

デフォルトではチェックされていません。

アクセス制限

サーバにログインしたユーザが，ユーザ登録で指定されたホームディレクトリと，その下位のファイル以外にアクセスできないよう制限するかどうかを選択します。最上位は各ドライブのルートディレクトリとなるため，ドライブ間のアクセスはできなくなります。この設定は，すべてのユーザに適用されます。

なお，アクセス制限を選択してファイルやディレクトリの絶対パス名を表示・設定する場合の絶対パス名のルートディレクトリは，システムのルートディレクトリです。ただし，絶対パス名の様式をあらかじめ登録することによって，絶対パス名のルートディレクトリをホームディレクトリに変更できます。絶対パス名のルートディレクトリをホームディレクトリに変更する方法については，「3.13　アクセス制限機能での絶対パス名のルートディレクトリの変更機能」を参照してください。

デフォルトではチェックされていません。

注意事項

［環境定義］ダイアログボックスの［履歴情報保存件数］，［プロトコルトレースのファイルサイズ］，［モジュールトレースのファイルサイズ］の各値は，現在の値よりも小さな値を設定した場合，サービス再起動時に，該当する情報ファイルが削除されます。再起動前の情報が消えてしまいますので注意してください。なお，履歴情報は，履歴情報ディレクトリ¥FTSLOGSAVEファイルにバックアップされます。

3.1.2　JP1/FTPの環境を定義ファイルで定義する

JP1/FTPの環境設定の一部を，定義ファイルで定義できます。

次のように，定義ファイルを作成し定義情報を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥ftsenv.ini

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒2　定義ファイル（ftsenv.ini）の定義内容

セクション

キー

値

定義内容

[ENV_INFO_VIEW]

GEN_USER

ON|OFF≪OFF≫

管理者以外のユーザが，定義情報の内容を参照できるようにするかどうかを指定します。※1

ON：参照可能にします。

OFF：定義情報を表示しません。

[WELL_KNOWN_PORTS]

Enable

ON|OFF≪OFF≫

FTPサーバ側でPORTコマンドにwell-knownポート(0〜1023)が指定された場合，接続を許可するか否かを指定します。※2

ON：許可します。

OFF：拒否します。

[ANOTHER_ADDRESS]

Enable

ON|OFF≪OFF≫

FTPサーバ側でPORTコマンドに制御コネクションを確立したクライアント(IPアドレス)以外が指定された場合，接続を許可するか否かを指定します。※2

ON：許可します。

OFF：拒否します。

[MASK_CMD]

PORT

ON|OFF≪OFF≫

FTPサーバ側でPORTコマンドの受信を抑止するか否かを指定します。※2，※3

ON：抑止します。

OFF：抑止しません。

EPRT

ON|OFF≪OFF≫

FTPサーバ側でEPRTコマンドの受信を抑止するか否かを指定します。※2，※3

ON：抑止します。

OFF：抑止しません。

[C_WELL_KNOWN_PORTS]

Enable

ON|OFF≪OFF≫

FTPクライアント側で，PASVコマンド発行後にFTPサーバ側から受け取ったポート番号にwell-knownポート(0〜1023)が指定された場合，接続を許可するか否かを指定します。※4

ON：許可します。

OFF：拒否します。

[C_ANOTHER_ADDRESS]

Enable

ON|OFF≪OFF≫

FTPクライアント側で，PASVコマンド発行後にFTPサーバ側から受け取ったIPアドレスに制御コネクションを確立したサーバ(IPアドレス)以外が指定された場合，接続を許可するか否かを指定します。※4

ON：許可します。

OFF：拒否します。

注※1

バージョン8以前は，管理者以外のユーザは，参照できる定義情報と参照できない定義情報がありました。ONを指定した場合，バージョン8以前で参照できなかった定義情報が参照可能になります。

なお，運用管理コンソールを使用して定義情報を参照する場合は，管理者で行ってください。

注※2

この登録情報は，JP1/File Transmission Server/FTP Serverサービスを起動したあとに有効になります。

注※3

ONを指定した場合，FTPサーバは該当コマンドを受信すると，「500 'コマンド名': command not understood.」メッセージをFTPクライアントに応答します。

なお，該当コマンドのヘルプは無効にはなりません。

注※4

この登録情報は，JP1/File Transmission Server/FTP Clientサービスを起動したあとに有効になります。

3.2　ログインユーザの登録

ファイル伝送時にサーバにログインするログインユーザの登録をします。ここで登録したユーザ以外から，着信の要求があった場合は，サーバ側で着信を拒否します。ログインユーザは，サーバ側で［ログインユーザ登録］を起動し，［ログインユーザの登録］ウィンドウで登録します。

［ログインユーザの登録一覧］ウィンドウの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［ログインユーザの登録］を選択します。

［ログインユーザの登録一覧］ウィンドウを次の図に示します。

図3‒2　［ログインユーザの登録一覧］ウィンドウ

注意事項

ここで登録するログインユーザは，Windowsのログインユーザとは関係ありません。

3.2.1　ログインユーザを登録する

［ログインユーザの登録一覧］ウィンドウで，［登録］を選択する。

［ログインユーザの登録］ダイアログボックスが表示されます。

図3‒3　［ログインユーザの登録］ダイアログボックス

各項目を設定し，［登録］をクリックする。

［閉じる］をクリックするまで，続けて複数のユーザの登録ができます。

登録後，［閉じる］をクリックする。

［ログインユーザの登録］ダイアログボックスの各設定項目を次の表に示します。

表3‒3　［ログインユーザの登録］ダイアログボックスの設定項目

項目

設定内容

ユーザ名

((1〜50バイトの文字列))

サーバに着信を許可するユーザ名を指定します。この項目に，日本語文字（2バイトコード）を指定すると，伝送相手のFTPクライアントによっては，アクセス拒否，文字化けなどを起こすことがあります。この項目は省略できません。また，次の文字は使用できません。

¥"/:<>|*?（いずれも半角文字）

先頭または末尾が半角スペース

パスワード

((0〜50バイトの文字列))

サーバにログインするときのパスワードを指定します。この項目に，日本語文字（2バイトコード）を指定すると，伝送相手のFTPクライアントによっては，アクセス拒否，文字化けなどを起こすことがあります。

パスワードを省略する場合は，何も入力しません。省略した場合，ファイルの着信時にパスワードのチェックはしません。

確認

［パスワード］で指定した内容を確認するために，再度同じパスワードを入力します。パスワードの設定を省略した場合は，何も入力しません。

ホームディレクトリ

((2〜259バイトの文字列))

ファイル伝送時に，ユーザが着信するディレクトリを指定します。伝送するファイル名が相対パスで指定された場合，ここで指定したホームディレクトリが基点となり，処理されます。［参照］をクリックしてシステムのディレクトリを指定することもできます。この項目は省略できません。

3.2.2　ログインユーザ情報を変更する

登録したログインユーザ情報のうち，パスワードとホームディレクトリは変更できます。

［ログインユーザの登録一覧］ウィンドウの一覧から，ユーザを選択し，［変更］を選択する。

［ユーザ情報の変更］ダイアログボックスが表示されます。

図3‒4　［ユーザ情報の変更］ダイアログボックス

変更する項目をチェックし，新しい内容を入力する。

パスワード，ホームディレクトリの両方を変更することもできます。

［変更］をクリックする。

3.2.3　ログインユーザ情報を削除する

登録したログインユーザ情報を，［ログインユーザの登録一覧］ウィンドウから削除します。ログインユーザ情報を削除すると，ユーザに設定されている自動起動プログラムも削除されます。

［ログインユーザの登録一覧］ウィンドウの一覧から，削除するユーザを選択する。

複数のユーザを一度に削除する場合は，［Shift］キーまたは［Ctrl］キーを押しながら，ユーザを選択します。

［削除］を選択する。

確認のメッセージが表示されます。

［はい］をクリックする。

3.3　自動起動プログラムの登録

ファイル伝送後にサーバで起動するプログラムを登録します。

自動起動プログラムは，サーバ側で［自動起動プログラムの登録］を起動し，［自動起動プログラムの登録一覧］ウィンドウで登録します。

［自動起動プログラムの登録一覧］ウィンドウの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［自動起動プログラムの登録］を選択します。

［自動起動プログラムの登録一覧］ウィンドウが表示されます。［自動起動プログラムの登録一覧］ウィンドウを次の図に示します。

図3‒5　［自動起動プログラムの登録一覧］ウィンドウ

3.3.1　自動起動プログラムを登録する

自動起動プログラムの登録の特長を次に示します。

伝送の正常終了時，異常終了時に，それぞれ別のプログラムを登録できます。

次のどちらかを対象に，プログラムを起動します。

ファイル名

指定したファイルの伝送を契機にプログラムを起動する

ディレクトリ名

指定されたディレクトリにファイルが伝送されたのを契機にプログラムを起動する

自動起動プログラムは，登録したユーザに対し，伝送が完了したのを契機にプログラムが実行されます。ユーザに関係なく自動起動をしたいときには，［ユーザ名］に「.default（デフォルトユーザ）」を登録します。

自動起動プログラムの登録は，新規に登録する方法と，既存の登録情報をひな形として，登録内容を書き換え，別の登録情報として登録する方法があります。

［自動起動プログラムの登録一覧］ウィンドウで［登録］−［ファイル対応の情報登録］または［ディレクトリ対応の情報登録］を選択する。または，既存の登録情報を指定し，［登録］−［ファイル対応の情報登録］または［ディレクトリ対応の情報登録］を選択する。

［自動起動プログラムの登録］ダイアログボックスが表示されます。

図3‒6　［自動起動プログラムの登録］ダイアログボックス（ファイル対応）

各項目を設定し，［登録］をクリックする。

［閉じる］をクリックするまで，続けて複数の自動起動プログラムの登録ができます。

登録後，［閉じる］をクリックする。

［自動起動プログラムの登録］ダイアログボックスの各設定項目を次の表に示します。

表3‒4　［自動起動プログラムの登録］ダイアログボックスの設定項目

項目

設定内容

ユーザ名

((一覧に表示されるユーザ))

自動起動プログラムを登録するユーザ名を指定します。この項目は省略できません。

登録できるユーザは，ドロップダウンリストの一覧に表示される次のユーザです。

JP1/FTPのログインユーザに登録されているユーザ

「.default」（デフォルトユーザ）：ログインユーザに登録されているすべてのユーザ

個々のユーザに該当する登録情報がないときは，デフォルトユーザの登録情報を参照し，該当する項目があれば，プログラムを自動起動する。

［ユーザ名］にすでに特定のユーザ名が指定されている場合

［表示］−［指定ユーザの情報］で，ユーザが指定されている場合，特定のユーザ名が表示されます。［表示］−［全てのユーザの情報］を選択してください。

ファイル名／ディレクトリ名

((1〜259バイトの文字列))

自動起動の対象になるファイル名，またはディレクトリ名を指定します。この項目は省略できません。

ファイル名を指定する場合は，フルパスまたはファイル名だけを指定します。ディレクトリ名を指定する場合は，フルパスで指定します。ディレクトリ区切り文字には「¥」を使用してください。

正常時に起動するプログラム名

異常時に起動するプログラム名

((2〜259バイトの文字列))

伝送の正常終了時，または異常終了時に起動するプログラムを指定します。

起動するプログラム名は，フルパスで指定します。プログラムの起動時に，伝送情報を引数として渡せます。詳しくは，「（1） 引数キーワード」を参照してください。なお，引数キーワードを変換後，文字列が2,048バイト以上になる場合，指定した自動起動プログラムの起動に失敗します。

プログラム名にスペースが含まれる場合

指定するプログラム名にスペースが含まれる場合は，プログラム名を引用符（"）で囲んでください。

例：自動起動プログラム名にc:¥aaa△bbb¥ccc△ddd.exeを指定する場合

"c:¥aaa△bbb¥ccc△ddd.exe" （△：半角スペース）

ただし，バッチファイルを指定する場合は，プログラム名と引数の両方を引用符で囲むと，引数が正しく渡されません。

起動プログラムに設定するプログラムについて

起動プログラムは，JP1/File Transmission Server/FTP Serverサービスから起動します。そのため，次の点に注意してください。

JP1/File Transmission Server/FTP Serverサービスを起動したアカウント（ユーザ）の権限の範囲で実行できるプログラムを指定してください。

ユーザのログオンセッションとは独立したサービスのセッションで実行しているため，ユーザのログオンセッションでレジストリなどに設定した情報は，読み込めないことがあります。

画面を持つプログラムは指定できません。画面を持つプログラムを起動すると，JP1/FTPの処理に影響を及ぼしたり，サービスが停止したりするおそれがあります。

プログラム起動時の優先順位について

自動起動プログラムが複数登録されている場合，起動条件となる情報（ファイル名，ディレクトリ名）は同じで，起動するプログラムが異なるということがあります。その場合，次のような優先順位で検索し，最初の条件にあったプログラムだけを起動します。優先順位を次の図に示します。

図3‒7　自動起動プログラム起動時の優先順位

複数ファイル伝送時のプログラム起動方法

ワイルドカードを使用した複数ファイル伝送を行った場合，ファイル伝送の数だけ自動起動プログラムが起動します。自動起動プログラムに引き継ぐ情報は，1伝送毎の情報だけです。すべての伝送情報を一度に自動起動プログラムへ引き継ぐ事はできません。

(1)　引数キーワード

自動起動プログラムに，引数キーワードを指定して，ユーザプログラムに全伝送終了情報を渡せます。また，キーワードを指定することで，個別の伝送終了情報を渡すこともできます。キーワードの一覧を次の表に示します。

表3‒5　引数キーワード一覧

引数キーワード

キーワード出力内容

クライアント（発信）

サーバ（着信）

ALL

以下の項目をすべて出力

○

○

TRNO

伝送番号

○

○

TCNO

接続番号

○

○

CARD

カード名

○

−

HOST

接続先ホスト名称またはIPアドレス

○

−

接続クライアントIPアドレス

−

○

PORT

接続先ホストポート番号

○

−

USER

ログインユーザ名

○

○

TRTP

伝送モード［ascii=1,binary=2］

○

○

TRCM

伝送コマンド［send=1,recv=2,append=3］

○

○

COMP

圧縮モード［stream=1,comp=2］

○

○

LCFN

ローカルファイル名

○

○

RMFN

リモートファイル名

○

−

STTM

伝送開始時間（time( )の戻り値）

○

○

SPTM

伝送終了時間（time( )の戻り値）

○

○

TRSZ

伝送データサイズ（バイト）

○

○

CMNT

コメント

○

−

TRST

伝送終了状態［成功=1,失敗=2］

○

○

ERKD

エラー種別［システムコールエラー=1，論理エラー=2，プロトコルエラー=3］

○

○

SYCN

システムコール名称

○

○

SYKD

システムコール種別［Win32 API=1，C runtime=2， Winsock API=3］

○

○

ERNO

エラー番号

○

○

PLMG

プロトコルメッセージ

○

−

（凡例）

○：有効

−：無効

キーワードの指定について

上記表以外のものを指定した場合，または無効なキーを指定した場合は，指定したキーワードがユーザプログラムに直接渡されます。

自動起動プログラムに渡す引数情報にスペースが含まれる場合，引数を指定するときに，キーワードを引用符（"）で囲む必要があります。

例："ALL"

また，キーワードを引用符で囲んだ場合，引数の渡され方がexeファイルとbatファイルで次のように異なります。

例：A.exe "PLMG"  aargv[1]=aaa  bbb
例：A.bat "PLMG"  a%1="aaa  bbb"

引数指定例

引数を指定した例を次に示します。

全伝送終了情報

C:¥USERS¥keiri¥PROC ALL

個別の伝送終了情報

C:¥USERS¥keiri¥PROC1 TRNO USER TRCM STTM SPTM
C:¥USERS¥keiri¥PROC2 "PLMG"

実行時のコマンドライン

例1：キーワードの指定（引用符なし）

指定

C:¥USERS¥keiri¥PROC1 TRNO USER TRCM STTM SPTM

実行コマンドライン

C:¥USERS¥keiri¥PROC1 12 keiri 1 12:45:35 12:45:45
（伝送の接続番号が12，ログインユーザ名がkeiri，伝送コマンドがsend(1)，伝送開始時間が12:45:35，伝送終了時間が12:45:45の場合）

例2：キーワードの指定（引用符あり）

指定

C:¥USERS¥WAKA¥PROC2 "PLMG"

実行コマンドライン

C:¥USERS¥WAKA¥PROC2 "550 D:¥temp¥test.dat:The system cannot find the path specified."
（プロトコルメッセージが550，D:¥temp¥test.dat:The system cannot find the path specified.の場合）

ユーザは終了プロシジャ内でGetCommandLine関数を使用して，コマンドラインの全文字列を取得できます。また，ユーザプログラムがCランタイムプロセスであれば，argc/argvのメカニズムを利用できます。

3.3.2　自動起動プログラムを変更する

登録した自動起動プログラムの内容を変更します。

［自動起動プログラムの登録一覧］ウィンドウから変更する情報を選択し，［変更］をクリックする。

［自動起動プログラムの変更］ダイアログボックスが表示されます。

図3‒8　［自動起動プログラムの変更］ダイアログボックス

変更する項目に，新しい内容を入力する。

［変更］をクリックする。

3.3.3　自動起動プログラムを削除する

登録した自動起動プログラムを，［自動起動プログラムの登録一覧］ウィンドウから削除します。

［自動起動プログラムの登録一覧］ウィンドウから削除する情報を選択する。

複数の情報を一度に削除する場合は，［Shift］キーまたは［Ctrl］キーを押しながら，情報を選択します。

［削除］を選択する。

確認のメッセージが表示されます。

［はい］をクリックする。

3.3.4　［自動起動プログラムの登録一覧］ウィンドウの表示内容を変更する

［自動起動プログラムの登録一覧］ウィンドウに表示する内容は，次の条件で変更できます。

自動起動プログラムを登録したユーザ（全ユーザ，指定ユーザ，デフォルトユーザ）

プログラムを起動する対象（ファイル，ディレクトリ）

(1)　自動起動プログラムを登録したユーザごとに表示する

［表示］−［全てのユーザの情報］，［指定ユーザの情報］または［デフォルトユーザの情報］を選択する。

［全てのユーザの情報］

登録されているすべての情報が表示されます。

［指定ユーザの情報］

表示したいユーザを［ユーザ名の指定］ダイアログボックスから指定します。［ユーザ名の指定］ダイアログボックスを次に示します。

図3‒9　［ユーザ名の指定］ダイアログボックス

［デフォルトユーザの情報］

デフォルトユーザの登録情報だけが表示されます。

(2)　プログラムを起動する対象（ファイルまたはディレクトリ）ごとに表示する

［ファイル／ディレクトリ］−［ファイル対応の情報］または［ディレクトリ対応の情報］を選択する。

［ファイル対応の情報］

ファイルに対応づけた情報だけが表示されます。

［ディレクトリ対応の情報］

ディレクトリに対応づけた情報だけが表示されます。

3.4　伝送情報の登録

伝送する内容（相手ホスト名，相手ユーザ名，伝送ファイルなど）を「伝送カード」に登録します。伝送後にクライアント側で起動させるプログラムを指定することもできます。

伝送情報の登録は，クライアント側で［伝送情報の登録／実行］を起動し，［伝送要求の登録／実行一覧］ウィンドウから，またはコマンドで実行します。

［伝送要求の登録／実行一覧］ウィンドウの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［伝送の登録／実行］を選択します。

［伝送要求の登録／実行一覧］ウィンドウが表示されます。［伝送要求の登録／実行一覧］ウィンドウを次の図に示します。

図3‒10　［伝送要求の登録／実行一覧］ウィンドウ

3.4.1　伝送情報を伝送カードに登録する

伝送情報を伝送カードに登録します。［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

また，伝送カードの登録は，既存の伝送カードをひな形として，登録内容を書き換え，別の伝送カードとして新規に登録することもできます。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで［登録］を選択する。または，既存の伝送カードを指定して［登録］を選択する。

［伝送情報の登録］ダイアログボックスが表示されます。

図3‒11　［伝送情報の登録］ダイアログボックス

各項目を設定し，［登録］をクリックする。

［閉じる］をクリックするまで，続けて複数の伝送情報の登録ができます。

登録後，［閉じる］をクリックする。

［伝送情報の登録］ダイアログボックスの各設定項目を次の表に示します。

表3‒6　［伝送情報の登録］ダイアログボックスの各設定項目

項目

設定内容

伝送カード名称

((1〜20バイトの文字列))

伝送情報に付ける任意の名称を指定します。JP1/AJS3と連携する場合は，スペースを含まない伝送カード名称を指定してください。この項目は省略できません。

相手ホスト名

((1〜256バイトの文字列))

伝送する相手のホスト名称，またはIPアドレスを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。この項目は省略できません。

ポート番号

((1〜65535))

《21》

伝送する相手のポート番号を指定します。省略した場合は，「21」が仮定されます。

JP1/FTPのサーバに伝送する場合

ポート番号の設定で「ftss」に指定したポート番号を指定します。

OS標準のFTPのサーバに伝送する場合

デフォルト値（21）のままでかまいません。

相手ユーザ名

((1〜50バイトの文字列))

伝送相手のログインユーザ名を指定します。この項目は省略できません。

パスワード

((0〜50バイトの文字列))

伝送相手のログインユーザのパスワードを指定します。登録時にパスワードを省略している場合は，何も入力しません。

送受信種別

伝送の種類を指定します。

送信

受信

伝送モード

伝送するファイルによって伝送モードを指定します。

ASCII：受信側で改行コードを自システムに合わせて変換する伝送モードです。テキストファイルなどを伝送するときに指定します。

BINARY：データの内容を意識しないで透過で伝送するモードです。データファイルや実行形式ファイルなどを伝送するときに指定します。

出力種別

伝送後のファイルの出力方法を指定します。

追加：すでに同名のファイルがある場合は，そのファイルに追加書きされます。同名のファイルがない場合は，新規に作成します。送受信種別が受信の場合は，追加を指定できません。

上書：すでに同名のファイルがある場合は，そのファイルを上書きし，既存のファイル内容はすべて破棄されます。同名のファイルがない場合は，新規に作成します。

圧縮モード

伝送するファイルを圧縮するかしないかを指定します。

圧縮指定について

相手先FTPサーバが圧縮モードをサポートしていない場合，圧縮を指定しても，非圧縮で伝送されます。

圧縮方法は，RFC959（FILE TRANSFER PROTOCOL）で定義されたランレングス圧縮方式です。

サイズ確認

ファイル伝送後に，送信側と受信側でファイルサイズに変化がないかを確認するかどうかを指定します。サイズが変わっていた場合は，伝送エラーになります。

なおサイズ確認には，相手先FTPサーバがJP1/FTP（06-00以降）またはuCosminexus Service Platform（08-53以降)であることが必要です。

単／複伝送

単一ファイル伝送をするか，複数ファイル伝送をするかを指定します。

自動切替：リモートファイル名に「*」または「?」が使用されている場合，複数ファイル伝送をします。使用されていない場合，単一ファイル伝送をします。

複数：複数ファイル伝送をします。ワイルドカードの指定のとおりに複数ファイルを伝送します。

単一：単一ファイルを伝送します。ワイルドカードの指定があっても，普通の文字として扱い，単一ファイルを伝送します。

ローカルファイル名

伝送種別が送信か受信かで，指定方法が次のように異なります。この項目は省略できません。

送信((1〜259バイトの文字列))

自システムから送信するファイル名を指定します。ワイルドカードを使って，複数ファイルを指定することもできます。ワイルドカードを使用する場合，展開後のパス名の長さが259バイト以下である必要があります。

複数ファイルの指定方法：次のワイルドカードのどちらかを使用して，複数ファイルの指定ができます。

*：0個以上のすべての文字とマッチ

?：任意の1文字とマッチ

複数のファイルを送信する場合，リモートファイル名にはディレクトリを指定してください。そのディレクトリの下に，ローカルファイル名と同じ名称で伝送されます。

受信((1〜259バイトの文字列))

ファイルを受信後，自システムに出力するファイル名を指定します。リモートファイル名にワイルドカードを指定した場合は，ディレクトリ名（ルートディレクトリは除く）を指定します。なお，ワイルドカード展開後のパス名の長さが259バイト以下である必要があります。

相対パスで指定する場合

JP1/FTPインストールディレクトリ¥tempの下に，指定したディレクトリおよびファイルがあれば伝送します。ディレクトリおよびファイルがないときは，伝送は異常終了します。

ローカルファイル名について

ローカルファイル名にショートカットの指定はできません。

リモートファイル名

伝送種別が送信か受信かで，指定方法が次のように異なります。この項目は省略できません。

送信((1〜259バイトの文字列))

相手システムの出力ファイル名を指定します。ローカルファイル名にワイルドカードを指定した場合は，ディレクトリ名を指定します。なお，ワイルドカード展開後のパス名の長さが259バイト以下である必要があります。

受信((1〜259バイトの文字列))

相手システムの入力元ファイル名を指定します。

ワイルドカード（「*」または「?」）を使って複数のファイルを指定できます。ワイルドカードを使用する場合，展開後のパス名の長さが259バイト以下である必要があります。

複数のファイルを受信する場合，ローカルファイル名にはディレクトリを指定してください。リモートファイル名と同じ名称で，指定したディレクトリにファイルが作成されます。

ワイルドカードの解釈について

NLSTコマンドにワイルドカードを指定して相手先FTPサーバに送信し，その応答から伝送するファイルを決めます。このため，ワイルドカードの解釈は相手先FTPサーバに依存します。

JP1/FTPの場合，ワイルドカードとして使用できる文字は，「*」または「?」です。ただし，ディレクトリ名の指定にワイルドカードは使用できません。ディレクトリ名にワイルドカード文字が含まれている場合は，単／複伝送を単一にして伝送してください。

相対パスで指定する場合

送受信ともに，カレントディレクトリからの相対になります。

リモートファイル指定について

［参照］によるファイル指定で参照できるのは，ローカルシステムから見たファイルです。リモートファイル名にはリモートシステムから見たファイル名を指定してください。

リモートファイル名に日本語文字（2バイトコード）を指定すると，相手先FTPサーバによっては，アクセス拒否，文字化けなどを起こすことがあります。

正常終了時起動プログラム名

((0〜259バイトの文字列))

伝送が正常終了したときに，クライアント（発信側）で自動起動させるプログラム名称をフルパスで指定します。引数を指定して，プログラム起動時に，プログラムへ伝送情報を引数として渡すこともできます。引数については，「3.3.1（1）引数キーワード」を参照してください。

なお，引数キーワードを変換後，文字列が2,048バイト以上になる場合，指定した自動起動プログラムの起動に失敗します。

異常終了時起動プログラム名

((0〜259バイトの文字列))

伝送が異常終了したときに，クライアント（発信側）で自動起動させるプログラム名称をフルパスで指定します。引数を指定して，プログラム起動時に，プログラムへ伝送情報を引数として渡すこともできます。引数については，「3.3.1（1）引数キーワード」を参照してください。

なお，引数キーワードを変換後，文字列が2,048バイト以上になる場合，指定した自動起動プログラムの起動に失敗します。

FTPコマンド

((0〜300バイトの文字列))

サーバと接続したあと，伝送する前に実行させるFTPコマンドを指定します。複数のコマンドを指定する場合は，「；（セミコロン）」でコマンド間を区切ってください。

(例)CWD C:¥users¥user1;SITE xxxx

指定できるコマンドは，データコネクションを確立しないコマンドに限られます。また，FTPサーバ側でコマンドが実行可能かどうかは，FTPサーバに依存します。

FTPサーバがJP1/FTPの場合

指定できる主なコマンド

CDUP，CWD，DELE，HELP，MDTM，MKD，NOOP，PWD，RMD，SITE，SIZE，STAT，SYST，XCUP，XCWD，XMKD，XPWD，XRMD

プロトコルトレースによって結果を参照できるコマンド

HELP，MDTM，SIZE，STAT，SYST

FTPコマンドの指定について

コマンドによっては連続したコマンドの送信が必要なものがあります。FTPの仕様を確認の上，使用してください。

引数を伴うコマンドを使用する場合，引数に日本語文字（2バイトコード）を指定すると，相手先FTPサーバによっては，アクセス拒否，文字化けなどを起こすことがあるので注意してください。

コメント

((0〜80バイトの文字列))

任意のコメントを記述できます。ここに記述されたコメントは，履歴情報にも表示されるので，どんな伝送かを記述しておくと便利です。コメントは，伝送相手には渡りません。

起動プログラムに設定するプログラムについて

起動プログラムは，JP1/File Transmission Server/FTP Clientサービスから起動します。そのため，次の点に注意してください。

JP1/File Transmission Server/FTP Clientサービスを起動したアカウント（ユーザ）の権限の範囲で実行できるプログラムを指定してください。

ユーザのログオンセッションとは独立したサービスのセッションで実行しているため，ユーザのログオンセッションでレジストリなどに設定した情報は，読み込めないことがあります。

画面を持つプログラムは指定できません。画面を持つプログラムを起動すると，JP1/FTPの処理に影響を及ぼしたり，サービスが停止したりするおそれがあります。

複数ファイル伝送時のプログラム起動方法

ワイルドカードを使用した複数ファイル伝送を行った場合，ファイル伝送の数だけ自動起動プログラムが起動します。自動起動プログラムに引き継ぐ情報は，1伝送ごとの情報だけです。すべての伝送情報を一度に自動起動プログラムへ引き継ぐ事はできません。

(2)　ftsregcコマンドで実行する

新規に伝送情報を登録するコマンドの例を，次に示します。

次の内容を登録する。

/TC：伝送カード名を「card1」

/TH：接続先ホスト名を「host1」

/TU：ログインユーザ名を「keiri」

/TT：送受信種別を「SEND（送信）」

/TY：伝送モードを「BINARY」

/TL：ローカルファイル名を「c:¥temp¥file1」

/TR：リモートファイル名を「c:¥temp¥file2」

既存の伝送カードを利用して伝送情報を登録するコマンドの例を，次に示します。

次の内容を登録する。

利用する既存の伝送カード名：「card1」

/TC：別の伝送カードとして登録する名前を「card2」

/TH：接続先ホスト名を「host1」

/TU：ログインユーザ名を「keiri」

/TT：送受信種別を「SEND（送信）」

/TY：伝送モードを「BINARY」

/TL：ローカルファイル名を「c:¥temp¥file1」

/TR：リモートファイル名を「c:¥temp¥file2」

ftsregcコマンドについては，「6.　コマンド」の「ftsregc−伝送情報の登録・変更・削除・表示−」を参照してください。

3.4.2　伝送カードの登録内容を変更する

登録した伝送カードの内容を変更します。［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで，変更する伝送カードを選択し，［変更］を選択する。

［伝送情報の変更］ダイアログボックスが表示されます。

図3‒12　［伝送情報の変更］ダイアログボックス

変更する項目に，新しい内容を入力する。

［変更］をクリックする。

(2)　ftsregcコマンドで実行する

伝送カードの内容を変更するコマンドの例を，次に示します。

card1の伝送情報のうち，次の情報を変更する。

/TC：カード名を「card2」

/TH：接続先ホスト名を「host1」

/TL：ローカルファイル名を「c:¥temp¥file1」

/TR：リモートファイル名を「c:¥temp¥file2」

ftsregcコマンドについては，「6.　コマンド」の「ftsregc−伝送情報の登録・変更・削除・表示−」を参照してください。

3.4.3　伝送カードを削除する

登録した伝送カードを［伝送要求の登録／実行一覧］ウィンドウから削除します。［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで，削除する伝送カードを選択する。

複数の伝送カードを一度に削除する場合は，［Shift］キーまたは［Ctrl］キー押しながら，伝送カードを選択します。

［削除］を選択する。

確認のメッセージが表示されます。

［はい］をクリックする。

(2)　ftsregcコマンドで実行する

伝送カードを削除するコマンドの例を，次に示します。

ftsregcコマンドについては，「6.　コマンド」の「ftsregc−伝送情報の登録・変更・削除・表示−」を参照してください。

3.4.4　伝送カードの内容を確認する

伝送前などに，伝送カードの内容を確認します。［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで，内容を表示する伝送カードを選択し，［詳細］を選択する。

［カード詳細］ダイアログボックスが表示されます。

内容確認後，［OK］をクリックする。

(2)　ftsregcコマンドで実行する

伝送カードの内容を表示するコマンドの例を，次に示します。

ftsregcコマンドについては，「6.　コマンド」の「ftsregc−伝送情報の登録・変更・削除・表示−」を参照してください。

3.5　ファイル伝送

ファイル伝送には，次の2つの実行方法があります。

選択実行

登録済みの伝送カードを［伝送要求の登録／実行一覧］ウィンドウから指定して，伝送を実行します。

オンデマンド実行

伝送カードに指定した伝送内容を伝送カードに登録しないで，そのまま伝送を実行します。

伝送はクライアント側で［伝送の登録／実行］を起動し，［伝送要求の登録／実行一覧］ウィンドウから，またはコマンドで実行します。

［伝送要求の登録／実行一覧］ウィンドウの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［伝送の登録／実行］を選択します。

［伝送要求の登録／実行一覧］ウィンドウが表示されます。［伝送要求の登録／実行一覧］ウィンドウを次の図に示します。

図3‒13　［伝送要求の登録／実行一覧］ウィンドウ

3.5.1　伝送カードを指定して伝送する（選択実行）

伝送カードを指定して，伝送します。複数の伝送カードを指定して伝送することもできます。

［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで，伝送する伝送カードを選択する。

複数の伝送カードを指定するときは，［Shift］キーまたは［Ctrl］キーを押しながら伝送カードを指定します。

［選択実行］を選択する。

［伝送の実行］ダイアログボックスが表示されます。

図3‒14　［伝送の実行］ダイアログボックス

伝送の順番を変更するには

選択実行では，［伝送の実行］ダイアログボックスの一覧に表示されている順に伝送をします。順番を変更するには伝送カードをダブルクリックします。ダブルクリックした伝送カードがリストの先頭に表示され，最初に伝送されます。

［同期実行］または［非同期実行］をクリックする。

同期実行

カード名ごとに順に伝送を実行します。前のファイル伝送が終了するまで，次のファイルの伝送をしません。そのため回線に負担が掛かりません。

伝送結果が［伝送の実行］ダイアログボックスの詳細の下に表示されます。（ ）内の数字は該当ファイル伝送の伝送番号を示します。伝送前のエラーについては，伝送番号は表示されません。

非同期実行

カード全体を一括して伝送します。同時に伝送できるファイル数は60です。また，非同期実行をすると，「登録しました」というメッセージが表示され，伝送の結果は表示されません。伝送の結果は履歴表示で確認してください。

伝送後，［閉じる］をクリックする。

ファイル伝送の中断方法

［同期実行］または［非同期実行］をクリックすると，［中断］または［強制中断］が表示されます。

［中断］

同期実行：実行中のファイル伝送が終了してから，要求を中断します。

非同期実行：要求中のファイル伝送が登録されてから，要求を中断します。

JP1/File Transmission Server/FTP Clientサービスと接続中のときは，接続の終了を待ってから中断します。

［強制中断］

［強制中断］をクリックすると伝送を即時中断します。ただし，非同期実行を指定している場合で，すでに登録済みの伝送は中断されません。なお，ファイル伝送の履歴は，出力されない場合があります。

強制中断すると資源を解放できないことがあるため，できるだけ使用は避けてください。

ワイルドカードを使用したファイル伝送のエラー表示について

「コメント及び伝送結果」には，最初に発生したエラーだけが表示されます。

(2)　ftstranコマンドで実行する

選択実行するコマンドの例を，次に示します。

ftstranコマンドによる伝送は，同期実行だけです。ftstranコマンドについては，「6.　コマンド」の「ftstran−伝送の実行−」を参照してください。

3.5.2　伝送カードを入力してそのまま伝送する（オンデマンド実行）

伝送カードに入力した内容をそのまま伝送します。新規に伝送カードを入力して実行する方法と，既存の伝送カードを利用し，内容を修正して実行する方法があります。オンデマンド実行では，伝送内容を伝送カードに登録しません。

［伝送要求の登録／実行一覧］ウィンドウから実行する方法と，コマンドで実行する方法を説明します。

(1)　［伝送要求の登録／実行一覧］ウィンドウで実行する

［伝送要求の登録／実行一覧］ウィンドウで［オンデマンド実行］を選択する。または［伝送要求の登録／実行一覧］ウィンドウから利用する伝送カードを指定して［オンデマンド実行］を選択する。

［オンデマンド実行］ダイアログボックスが表示されます。

図3‒15　［オンデマンド実行］ダイアログボックス

伝送内容を入力または修正する。

各項目の設定内容については，「3.4.1 伝送情報を伝送カードに登録する」を参照してください。

［同期実行］または［非同期実行］をクリックする。

同期実行

カード名ごとに順に伝送を実行します。前のファイル伝送が終了するまで，次のファイルの伝送をしません。そのため回線に負担が掛かりません。

非同期実行

カード全体を一括して伝送します。同時に伝送できるファイル数は60です。また，非同期実行をすると，「登録しました」というメッセージが表示され，伝送の結果は表示されません。伝送の終了結果は履歴表示で確認してください。

伝送後，［閉じる］をクリックする。

ファイル伝送の中断方法

［同期実行］または［非同期実行］をクリックすると，「実行中」のダイアログボックスが表示されます。ダイアログボックスの［強制中断］をクリックすると，即座に伝送を中断します。なお，ファイル伝送の履歴は，出力されない場合があります。

伝送を強制中断したあとに，同期実行すると，伝送開始までに時間が掛かる場合があります。

ワイルドカードを使用したファイル伝送のエラー表示について

伝送後に表示されるメッセージに，最初に発生したエラーだけが表示されます。

(2)　ftstranコマンドで実行する

オンデマンド実行するコマンドの例を，次に示します。

card1の伝送情報のうち，次の情報を変更して伝送する。

/TC：カード名を「card2」

/TH：接続先ホスト名を「host1」

/TT：送受信種別を「SEND（送信）」

/TY：伝送モードを「BINARY」

/TL：ローカルファイル名を「c:¥temp¥file1」

/TR：リモートファイル名を「c:¥temp¥file2」

ftstranコマンドによる伝送は，同期実行だけです。ftstranコマンドについては，「6.　コマンド」の「ftstran−伝送の実行−」を参照してください。

3.6　伝送履歴の確認

ファイル伝送の履歴（伝送時刻，伝送ファイル名，伝送結果と詳細，エラーの詳細など）を確認します。

履歴表示はサーバ，クライアントどちらからでもでき，［履歴情報の表示］を起動し，［履歴情報の一覧］ウィンドウで表示します。または，ftshistoryコマンドで表示します。

［履歴情報の一覧］ウィンドウの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［履歴情報の表示］を選択します。

［履歴情報の一覧］ウィンドウが表示されます。［履歴情報の一覧］ウィンドウを次の図に示します。

図3‒16　［履歴情報の一覧］ウィンドウ

3.6.1　伝送結果の詳細やエラーを確認する

履歴情報の一覧から，詳細情報を表示します。

［履歴情報の一覧］ウィンドウから詳細を表示する履歴情報を選択し，［詳細］を選択する。

［詳細情報］ダイアログボックスが表示されます。プロトコルトレース，エラーが出ている場合は，エラーの詳細を確認できます。

図3‒17　［詳細情報］ダイアログボックス

詳細情報を確認後，［OK］をクリックする。

［詳細情報］ダイアログボックスの各表示項目を，次の表に示します。

表3‒7　［詳細情報］ダイアログボックスの表示項目

項目

表示内容

伝送番号

伝送の通番が表示されます。通番はサーバ（着信），クライアント（発信）をそれぞれ別々にカウントします。伝送ごとにユニークな番号になるので履歴を参照する際の識別子として利用できます。伝送番号は最大999999で，この値を超えると0に戻ります。

伝送カード名

発信（クライアント）：伝送したカードの名称が表示されます。

着信（サーバ）：表示されません。

伝送日時

伝送の開始から終了までの日時が表示されます。

相手ホスト名

伝送要求時に指定した伝送相手が表示されます。システムで定義されているホスト名，またはIPアドレスが表示されます。

相手ポート番号

発信（クライアント）：伝送をした相手のポート番号が表示されます。

着信（サーバ）：表示されません。

ログインユーザ名

発信（クライアント）：伝送した相手のログインユーザ名が表示されます。

着信（サーバ）：着信したログインユーザ名が表示されます。

発着信種別

発信（クライアント）：発信によるファイル伝送をしたときに表示されます。

着信（サーバ）：着信によるファイル伝送をしたときに表示されます。

送受信種別

伝送要求時に指定した送受信種別（送信，または受信）が表示されます。

出力種別

伝送要求時に指定した出力種別（追加，または上書）が表示されます。

伝送モード

伝送要求時に指定した伝送モード（ASCII，またはBINARY）が表示されます。

圧縮モード

伝送要求時に指定した圧縮モード（圧縮，または非圧縮）が表示されます。

終了状態

ファイル伝送の終了状態（正常，または異常）が表示されます。

プログラムの自動起動に失敗してもファイル伝送自体が正常終了していれば「正常」と表示されます。

伝送時間

ファイル伝送に掛かった時間が表示されます。24時間以上掛かった場合，日数の表示はしません。

伝送サイズ

伝送したファイルのデータサイズ（バイト）が表示されます。

接続番号

JP1/FTP が相手システムと接続したときの識別子です。サーバとクライアントでそれぞれ1から60まで（最大接続数によって最大数は異なります）の番号が表示されます。プロトコルトレースなどの各種トレースは，この接続番号単位に出力するので，該当伝送のトレースを参照するときに使用します。

例：［接続番号］が「2」のとき

クライアントのプロトコルトレースファイル：CSProtocolTrace2

サーバのプロトコルトレースファイル：SSProtocolTrace2

ローカルファイル名

送信した場合：自システムから送信したファイル名が表示されます。

受信した場合：自システムに受信したファイル名が表示されます。

リモートファイル名

発信（クライアント）：

送信：相手システムの出力ファイル名が表示されます。

受信：入力元ファイル名がそのまま表示されます。

着信（サーバ）：表示されません。

コメント

発信（クライアント）：伝送要求時に指定したコメントが表示されます。

着信（サーバ）：表示されません。

エラー種別

伝送状態が異常のとき，次のどれかが表示されます。エラーの詳細は［エラー詳細］で参照できます。

システムコールエラー

プロトコルエラー

論理エラー

プロトコルトレース

伝送の開始から終了までの内部動作が表示されます。

なお，応答コードの前に「*」が付加されている応答は，相手サーバから実際に受信した応答ではなく，JP1/FTPクライアントが内部で生成した応答を示しています。

07-50以降で出力されたプロトコルトレースについては，該当する伝送のトレースが表示されます。なお，該当する伝送のトレースがない場合には，すべてのトレースが表示されます。

エラー詳細

エラー種別，発生場所などエラーの詳細が表示されます。

3.6.2　［履歴情報の一覧］ウィンドウの表示内容を変更する

［履歴情報の一覧］ウィンドウに表示される内容は，最新の情報に更新したり，指定した条件の履歴だけを表示したりするなど，変更できます。

［履歴情報の一覧］ウィンドウから［表示］を選択し，表示したい内容を指定する。

［全ての情報］または［特定の情報］

全履歴を表示するか，特定の条件に合うものだけを表示するかを指定します。

［特定の情報］を指定すると，［表示の範囲］ダイアログボックスが表示されます。

［終了時刻でソート］または［開始時刻でソート］

一覧に表示する順序を，ファイル伝送が終了した時刻で新しい情報から表示するか，ファイル伝送を開始した時刻で新しい情報から表示するかを指定します。

［最新の情報に更新］

履歴情報を最新の情報に更新します。

図3‒18　［表示の範囲］ダイアログボックス

［表示の範囲］ダイアログボックスの各設定項目を，次の表に示します。

表3‒8　［表示の範囲］ダイアログボックスの設定項目

項目

設定内容

時刻の範囲

履歴情報を表示する時刻の範囲を指定します。左の欄で，表示時刻の起点を指定し，右の欄で日時の範囲を指定します。

左の欄（表示時刻の起点）

開始時刻で検索するか，終了時刻で検索するかを指定します。

右の欄（日時の範囲）

表示する日時の範囲を次の形式で指定します。

YYYY/MM/DD HH:MM:SS

YYYY：年，MM：月，DD：日，HH：時 MM：分 SS：秒

全情報

クリックすると，履歴ファイルに残っている履歴の最古の日付から最新の日付に変わります。

当日情報

クリックすると，日時範囲が当日の日付に変わります。

発着信種別

表示する履歴を発着信の種別で指定する場合に「発信（クライアント）」，または「着信（サーバ）」を指定します。指定する必要がない場合は「発信／着信」を指定します。

送受信種別

表示する履歴を送受信の種別で指定する場合に「送信」，または「受信」を指定します。指定する必要がない場合は「送信／受信」を指定します。

伝送終了状態

表示する履歴を伝送終了状態で指定する場合に「正常」，または「異常」を指定します。指定する必要がない場合は「正常／異常」を指定します。

3.6.3　表示する履歴ファイルを変更する

障害時などに別の履歴ファイルを読み込み，表示できます。

［履歴情報の一覧］ウィンドウから［ファイル］−［特定の履歴を指定］を選択する。

履歴ファイルを読み込むダイアログボックスが表示されます。

読み込む履歴ファイルを指定し，［開く］をクリックする。

指定した履歴ファイルが読み込まれます。

表示を稼働中の履歴ファイルに戻す場合は，［ファイル］−［稼動中の履歴］を選択します。

3.6.4　ftshistoryコマンドで履歴を表示する

履歴情報全件の詳細（デフォルトフォーマット）を表示する例を，次に示します。

ftshistoryコマンドについては，「6. コマンド」の「ftshistory−履歴情報の表示−」を参照してください。

3.7　定義情報の保存・復元

JP1/FTPの定義情報を保存し，別の環境で復元できます。1つのシステムで設定し，複数のシステムに配布することで，複数システムの環境を統一できます。保存，復元できる定義情報は，次の4つです。

環境情報

ログインユーザ情報

自動起動プログラム情報

伝送情報

定義情報の保存，復元は［定義情報の保存・復元］を起動し，［定義情報の保存・復元］ダイアログボックスから，またはコマンドで実行します。

［定義情報の保存・復元］ダイアログボックスの表示方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［定義情報の保存・復元］を選択します。

［定義情報の保存・復元］ダイアログボックスを次の図に示します。

図3‒19　［定義情報の保存・復元］ダイアログボックス

3.7.1　定義情報を保存する

定義情報を保存します。定義情報の保存は，［定義情報の保存・復元］ダイアログボックス，またはコマンドで実行します。

(1)　［定義情報の保存・復元］ダイアログボックスで実行する

［定義情報の保存・復元］ダイアログボックスで［保存］をクリックする。

［保存する情報の選択］ダイアログボックスが表示されます。［保存する情報の選択］ダイアログボックスを次の図に示します。

図3‒20　［保存する情報の選択］ダイアログボックス

保存する定義情報を選択し，任意のコメントを0〜40バイトの文字列で指定する。

コメントは，定義情報を復元するときに表示されます。コメントの入力は省略できます。

指定した定義情報に情報が何も登録されていない場合

登録情報がないままの状態で保存されます。このような情報は，復元時に復元情報として指定できますが，登録情報がないまま復元されます。

［OK］をクリックする。

保存するファイル名を指定するダイアログボックスが表示されます。

定義情報ファイルの保存場所，ファイル名を指定して，［開く］をクリックする。

［定義情報の保存・復元］ダイアログボックスで［閉じる］をクリックする。

(2)　ftssaveコマンドで実行する

定義情報を保存するコマンドの例を，次に示します。

すべての定義情報（環境情報，ログインユーザ情報，自動起動プログラム情報，伝送情報）を保存します。保存する定義情報を指定することもできます。

ftssaveコマンドについては，「6.　コマンド」の「ftssave−定義情報の保存−」を参照してください。

3.7.2　定義情報を復元する

保存した定義情報を復元します。定義情報の復元は，［定義情報の保存・復元］ダイアログボックス，またはコマンドで実行します。

また，定義情報の復元形式は，次の2つから選択できます。

元の情報を削除しない

復元先の元の定義情報を削除しないで，定義ファイルを復元します。

元の情報を削除する

復元先の元の定義情報を削除して，定義ファイルを復元します。

復元中に障害が発生した場合

復元中に障害が発生した場合，定義情報は復元されません。［元の情報を削除する］を指定する前に，元の情報を保存しておくことをお勧めします。

環境定義復元時の履歴情報ディレクトリについて

環境定義に指定されている履歴情報ディレクトリは，自動で作成されません。履歴情報ディレクトリがデフォルト以外の場合は，一度定義ユティリティで環境定義を更新してください。ディレクトリがないとJP1/FTPの各種サービスが起動できません。

(1)　［定義情報の保存・復元］ダイアログボックスで実行する

［定義情報の保存・復元］ダイアログボックスで［復元］をクリックする。

復元するファイルを指定するダイアログボックスが表示されます。

復元するファイルを指定し，［開く］をクリックする。

［復元する定義情報の選択］ダイアログボックスが表示されます。

図3‒21　［復元する情報の選択］ダイアログボックス

復元する定義情報を選択し，選択した情報の復元の方法を指定する。

［OK］をクリックする。

メッセージが表示されます。

［OK］をクリックする。

［定義情報の保存・復元］ダイアログボックスで［閉じる］をクリックする。

［復元する情報の選択］ダイアログボックスの各設定項目を次の表に示します。

表3‒9　［復元する情報の選択］ダイアログボックスの設定項目

項目

設定内容

復元する定義情報

復元する定義情報を選択します。

［環境情報］

環境定義ユティリティで設定する情報を復元します。

［ログインユーザ情報］

ログインユーザの登録で登録した情報を復元します。

［自動起動プログラム情報］

自動起動プログラムの登録で登録した情報を復元します。

［伝送情報］

伝送の登録／実行で登録した情報を復元します。

復元の方法

元の定義情報を削除するか，しないかを選択します。

元の情報を削除しない

復元先の定義情報を削除しないで，保存した定義ファイルの情報を復元します。

復元先に次に示すキーの情報があるときは，保存したファイルの情報に更新します。復元先に同一キーの情報がないときは，保存ファイルの情報を追加します。

次のものがキーになります。

環境定義：環境定義全体が1つのキーになります。

ログインユーザ情報：ユーザ名

自動起動プログラム情報：ファイル名，ディレクトリ名

伝送情報：カード名

元の情報を削除する

復元先の定義情報を削除してから，保存したファイルの情報を復元します。保存したファイルの情報がそのまま定義情報となるため，不要な定義情報が残りません。元の情報の削除はチェックした定義情報単位で削除されます。ただし，環境定義情報は削除されません。また，ユーザ情報を削除したときは，自動起動プログラム情報も削除されます。

コメント

定義情報保存時に登録されたコメントが表示されます。

(2)　ftsloadコマンドで実行する

保存した定義情報を復元するコマンドの例を，次に示します。

すべての定義情報（環境情報，ログインユーザ情報，自動起動プログラム情報，伝送情報）を，元の情報を削除しないで復元します。復元する定義情報を指定したり，元の情報を削除して復元したりすることもできます。

ftsloadコマンドについては，「6.　コマンド」の「ftsload−定義情報の復元−」を参照してください。

3.8　定義情報のテキスト出力

次の4つの定義情報は，テキストに出力できます。

ログインユーザ情報

自動起動プログラム情報

伝送情報

履歴情報

定義情報を出力するフォーマットは，インストール時にサンプルのフォーマットファイルが設定されています。フォーマットファイルは，使いやすい形式に変更できます。フォーマットファイルについては，「付録E 定義情報を出力するフォーマットファイルについて」を参照してください。

3.8.1　定義情報をテキスト出力する

定義情報のテキスト出力は，各登録ウィンドウの［ファイル］メニューから実行します。

また，テキスト出力の形式は，次の2つから選択できます。

テキスト出力

指定したファイルに情報を出力します。既存のファイルを指定した場合は，元のファイル内容は上書きされます。

テキスト追加出力

指定したファイルの最終行以降に情報を追加出力します。

Windowsの［スタート］メニューから［JP1_File Transmission Server_FTP］−［（テキスト出力する定義情報の登録ウィンドウ）］を選択する。

［ファイル］−［＊＊のテキスト出力］または［＊＊のテキスト追加出力］を選択する（＊＊は定義情報名）。

出力先ファイルを指定するダイアログボックスが表示されます。

出力先ファイルを指定し，［開く］をクリックする。

自動起動プログラムのフォーマットファイルとテキスト出力の例を，次の図に示します。

図3‒22　フォーマットファイル

図3‒23　テキスト出力の例

3.9　PASVモードでのファイル伝送

FTPクライアント側で，PASVモードでファイルを伝送できます。

接続する相手FTPサーバのホストごとにPASVモードでのファイル伝送をします。

PASVモードでファイル伝送するには，PASVモードでファイル伝送したい相手FTPサーバのホスト名をあらかじめ登録しておきます。

この登録情報は，クライアントサービスを起動したあとに有効になります。

3.9.1　ホスト名を登録する

次のように，定義ファイルを作成しホスト名を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥FTPPASV.INI

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒10　PASVモード対応用定義ファイルの定義内容

セクション

キー

値

定義内容

[PasvMode]

MaxInfoCount

ホスト数の最大値 | ALL

PASVモードでファイル伝送する相手FTPサーバのホストの数を指定します。

ホスト数の最大値：次行以降に指定するHostName[X]のXの最大値を指定します。

ALL：すべての相手FTPサーバホストに対してPASVモードでファイル伝送することを指定します。ALLを指定すると，HostName[X]の指定は無視されます。

HostName[X]

ホスト名

PASVモードでファイル伝送する相手FTPサーバのホスト名またはIPアドレスを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。登録するホストごとに1行ずつ記述します。

ホスト名には，伝送情報の相手ホスト名と同じ文字を記述してください。

Xには1以上MaxInfoCountの値以下の数値を指定してください。MaxInfoCountの値を超えた場合は無視されます。

Xは重複して指定しないでください。

Xの順序は任意です。

（内容の例）

（例1）HOST1，HOST2に対してPASVモードで伝送する場合

（例2）すべてのホストに対してPASVモードで伝送する場合

3.10　接続ホスト制限機能

FTPサーバ側で，接続してくるFTPクライアントを制限できます。

接続を許可したいFTPクライアントのIPアドレスまたはホスト名を許可リストに定義すると，定義したFTPクライアントと伝送できます。また，接続を拒否したいFTPクライアントのIPアドレスまたはホスト名を拒否リストに定義すると，接続を制限できます。

この機能では，FTPクライアントからFTPサーバに接続してきた時点での定義内容に従ってチェックされます。接続が拒否される場合，制御コネクション接続直後の応答メッセージが返信されないで，制御コネクションが切断されます。

なお，JP1/File Transmission Server/FTP Serverサービス起動中でも定義を変更できます。

3.10.1　ホスト名を登録する

次のように，定義ファイルを作成し，ホスト名を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥FTPHOSTACC.INF

(2)　定義ファイルの内容

次の定義方法に従い，テキストエディターを使用して定義ファイル（FTPHOSTACC.INF）に記述してください。

はじめに定義名を記述します。定義名の次の行以降に指定値を記述します。指定値を複数記述する場合は1行に1件ずつ記述してください。"#"以降の文字は，改行するまでコメントと見なされます。

指定できる定義名および指定値の内容を次の表に示します。

表3‒11　定義ファイル（FTPHOSTACC.INF）に指定できる定義名および指定値の内容

定義名

定義内容

指定値

[allow_list]

接続を許可するホストを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。

IPアドレスまたはホスト名

[deny_list]

接続を拒否するホストを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。

IPアドレスまたはホスト名

IPv6アドレスで指定する場合，指定できる形式を次の表に示します。

表3‒12　IPv6アドレスで指定できる形式

項番

指定アドレス

内容

定義

1

2001:0db8:0020:0003:1000:0100:0020:0003

128ビットすべて指定

有効

2

2001:db8::9abc

部分省略

有効

3

::1

ループバックアドレス指定

有効

4

2001:F123:2221:2312:3333:4444::/96

マスク指定

有効

5

2001:128:222:333

後方省略指定

無効

6

2001:F123:2221:2312:3333:*:5555:6666

複数指定

無効

7

2001:F123:2221:2312:3333:4444:5555:1111-FFFF

複数範囲指定

無効

（内容の例）

(3)　注意事項

定義ファイルがない場合，すべてのホストからの接続が許可されます。

定義ファイルに有効な定義が記述されていない場合，すべてのホストからの接続が拒否されます。

定義ファイルに記述されていないホスト，および[allow_list]と[deny_list]の両方に記述されているホストからの接続は拒否されます。

IPv6アドレス指定の場合，マスク値は，アドレス部/xx（xx：10進数の1〜128）で指定します。

IPv6アドレス指定で，スコープID付き（%文字指定）のアドレスは無効となります。

3.11　複数IPアドレス環境での使用

複数NICを使用する環境やクラスタ環境のように，必要に応じて複数のIPアドレスを使い分けて通信する環境で次の機能が使用できます。

FTPクライアントでの自IPアドレスの指定を有効にする機能

FTPクライアントの定義にYESを定義し，APIやftstranコマンドの引数，カスタムジョブでのクライアントホスト名の入力フィールドに論理ホスト名を指定して登録すると，FTPクライアントの発信元アドレスを論理アドレスにすることができます。

FTPサーバで送信する応答メッセージ内のFTPサーバホスト名を，接続を受けたアドレスにする機能

FTPサーバの定義にYESまたはNOを定義すると，FTPサーバ側で送信する応答メッセージ内のFTPサーバホスト名として，接続されたIPアドレスから変換したホスト名や接続されたIPアドレスを設定できます。

JP1イベント送信先を指定する機能

JP1イベントの定義に論理ホスト名または論理IPアドレスを定義すると，指定したホストにJP1イベントを送信できます。

この機能は，定義ファイルを作成後，各サービスを起動したあとに有効になります。

3.11.1　定義ファイルを作成する

次のように，定義ファイルを作成してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥HOSTINFO.INI

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒13　定義ファイル（HOSTINFO.INI）の定義内容

セクション

キー

値

定義内容

[CSHOST]

CSHost

YES|NO

≪NO≫

FTPクライアント側で，ftstranコマンドの/H指定およびfts_ftp_open_ex()関数のhostname指定を有効にするかどうかを指定します。

YES：FTPクライアントの発信元アドレスを，ftstranコマンドの/Hまたはfts_ftp_open_ex()関数のhostnameで指定されたホスト名に対応するIPアドレスにします。

YESを指定してftstranコマンドの/H指定を省略した場合，物理ホスト名が仮定されます。また，YESを指定してfts_ftp_open_ex()関数のhostnameにNULLを指定した場合も，物理ホスト名が仮定されます。

NO：FTPクライアントの発信元アドレスを，OSが自動割り当てしたアドレスにします。

[RSPMSG]

Reverse

YES|NO|指定なし

≪指定なし≫

FTPサーバ側で送信する応答メッセージ内のFTPサーバホスト名の出力様式を指定します。

YES：接続されたIPアドレスから変換したホスト名が出力されます。

NO：接続されたIPアドレスが出力されます。

指定なし：物理ホスト名が出力されます。

[JP1EVENT]

HostName

ホスト名|IPアドレス|指定なし

≪指定なし≫

JP1イベントの送信先を指定します。

ホスト名｜IPアドレス：サービス（クライアント，サーバ，ログ，エージェント）の起動・停止のJP1イベントの送信先を指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。

また，伝送終了時のJP1イベントの送信先（論理，物理アドレス）は，伝送を実行したホストになります。

指定なし：すべてのJP1イベントの送信先を物理ホストにします。

AgentIsSame

YES|NO

≪YES≫

エージェントサービスの起動・停止のJP1イベントの送信先をHostNameで指定した送信先にするかどうかを指定します。

YES：JP1イベントの送信先をHostNameで指定した送信先にします。

NO：JP1イベントの送信先を物理ホストにします。

TransIsSame

YES|NO

≪NO≫

伝送終了時のJP1イベントの送信先をHostNameで指定した送信先にするかどうかを指定します。

YES：JP1イベントの送信先をHostNameで指定した送信先にします。

NO：JP1イベントの送信先を伝送を実行したホストにします。

定義指定値の組み合わせで決定する伝送終了時のJP1イベント送信先を，次の表に示します。

表3‒14　定義指定値の組み合わせで決定する伝送終了時のJP1イベント送信先

HostName

TransIsSame

伝送終了時のJP1イベント送信先

指定あり

YES

HostNameで指定したホスト

NO

伝送を実行したホスト

指定なし

YES

物理ホスト

NO

物理ホスト

（内容の例）

ftstranコマンドの/H指定およびfts_ftp_open_ex()関数のhostname指定を有効にします。

FTPサーバの応答メッセージ内のFTPサーバホスト名として，接続されたIPアドレスから変換したホスト名を設定します。

サービス（クライアント，サーバ，ログ，またはエージェント）の起動・停止，伝送終了時のJP1イベントの送信先をHost1（論理ホスト名=Host1）に設定します。

(3)　注意事項

定義ファイルがない場合，各機能は無効になります。その場合，各機能は省略値の動作になります。

3.12　アクセスログの採取

FTPクライアントが接続してからログイン（ユーザ認証）に成功するまでの不正または正常ではないアクセス内容をFTPサーバ側で記録できます。

3.12.1　アクセスログ採取の設定

アクセスログを採取するように設定するには，［環境定義］ダイアログボックスで「アクセスログのファイルサイズ」に1メガバイト以上の値を設定してください。［環境定義］ダイアログボックスについては，「3.1 JP1/FTPの環境定義」を参照してください。

3.12.2　採取先ファイル

アクセスログは，アクセスログファイルにテキスト出力されます。アクセスログの出力先ファイルおよびバックアップファイルを，次の表に示します。

表3‒15　アクセスログの出力先ファイルおよびバックアップファイル

内容

ファイル名

アクセスログファイル

（履歴情報ディレクトリ）¥ftsaccess.log

バックアップファイル

（履歴情報ディレクトリ）¥ftsaccess.log.old

ファイルサイズは，0から［環境定義］ダイアログボックスの「アクセスログのファイルサイズ」で指定したサイズまでになります。［環境定義］ダイアログボックスの「アクセスログのファイルサイズ」で指定したサイズを超える場合，ファイルをバックアップファイルにバックアップしてから，サイズを0バイトにして初めから書き込みます。

バックアップするとき，すでにバックアップファイルがあると，バックアップファイルを上書きします。

3.12.3　アクセスログに出力されるメッセージ

アクセスログに出力されるメッセージを次の表に示します。

表3‒16　アクセスログに出力されるメッセージ

出力されるメッセージ

要因

FTPコマンド※1 is invalid because it was sent by a user who was not logged in. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

ログイン後に実行可能になるFTPコマンドを，ログイン前に受け付けました。

Login of user ユーザ名※5 failed. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

ログインに失敗しました。

The max. number of FTP clients was reached. No more clients can use the service.

最大同時伝送数を超える接続を受け付けました。

The connection was closed without login. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

FTPクライアントが，ログインしないで接続を切断しました。

注※1

FTPコマンド：FTPコマンドを示します。

注※2

IPアドレス：FTPクライアントのIPアドレスを示します。

注※3

ポート番号：FTPクライアントのポート番号を示します。

注※4

接続番号：接続番号を示します。

注※5

ユーザ名：ユーザ名を示します。

3.13　アクセス制限機能での絶対パス名のルートディレクトリの変更機能

アクセス制限機能を使用する場合に，ファイルやディレクトリの絶対パス名のルートディレクトリをホームディレクトリに変更できます。

この機能によって，FTPユーザに，そのユーザのホームディレクトリから上の階層のディレクトリ構成を公開しないで，ファイルやディレクトリを表示・設定させることができます。

この機能を使用するには，絶対パス名の様式をあらかじめ登録しておきます。

この登録情報は，JP1/File Transmission Server/FTP Serverサービスを起動したあとに有効になります。

3.13.1　絶対パス名の様式を登録する

次のように，定義ファイルを作成し絶対パス名の様式を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥AccessLimitation.ini

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒17　定義ファイル（AccessLimitation.ini）の定義内容

セクション

キー

値

定義内容

[HomeDir]

Display

Root|FullPath

≪FullPath≫

ファイルやディレクトリの絶対パス名の様式を指定します。

Root：ルートディレクトリをホームディレクトリとした様式にします。

FullPath：ルートディレクトリをシステムのルートディレクトリとした様式にします（フルパスの様式にします）。

(3)　表示・指定様式の例

ディレクトリ構造が，次のような構造になっている場合について，表示と指定の様式を説明します。

（例1）

カレントディレクトリがホームディレクトリ（Dir02）で，標準FTPクライアントでpwdコマンドを入力したときに表示される応答メッセージ：

Rootを設定した場合：

257 "¥" is current directory.

FullPathを設定した場合：

257 "C:¥Dir01¥Dir02" is current directory.

（例2）

カレントディレクトリがホームディレクトリ（Dir02）で，標準FTPクライアントでFile01を削除するための指定方法：

Rootを設定した場合：

delete ¥File01

FullPathを設定した場合：

delete C:¥Dir01¥Dir02¥File01

(4)　注意事項

定義ファイルがない場合，フルパスの様式となります。

アクセス制限機能を使用しない場合，定義ファイルは無視されます。

イベントログに出力されるメッセージは，定義に関係なく常にフルパスの様式で出力されます。

3.14　FTP接続応答メッセージの情報抑止機能

FTP接続時の応答メッセージは，通常，次のように表示されます。

この応答メッセージ内のホスト名，製品名，およびバージョン情報を表示しないようにできます。また，この応答メッセージを任意の文字列にすることもできます。

FTP接続応答メッセージを変更するには，定義情報をあらかじめ登録しておきます。

この登録情報は，JP1/File Transmission Server/FTP Serverサービスを起動したあとに有効になります。

3.14.1　定義情報を登録する

次のように，定義ファイルを作成し定義情報を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥FtsBanner.ini

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒18　定義ファイル（FtsBanner.ini）の定義内容

セクション

キー

値

定義内容

[BANNER]

Display

ON|OFF

≪ON≫

FTP接続応答メッセージ内のホスト名，製品名，およびバージョン情報を表示するかどうかを指定します。

ON：表示します。

OFF：表示しません。

(3)　FTP接続応答メッセージファイルの作成

FTP接続応答メッセージを任意の文字列にする場合には，定義ファイルでDisplayをOFFに設定した上で，次のパス名でFTP接続応答メッセージファイルを作成してください。

JP1/FTPのインストールディレクトリ¥FtsBanner.txt

(4)　FTP接続応答メッセージファイルの内容

次のように，FTP接続応答メッセージ文字列を記述してください。

注意事項

FTP接続応答メッセージファイルは，1行以上で構成されます。

1行に指定できる文字数は，256バイト以内です。256バイトを超える文字は無視されます。

ファイルのサイズは，512バイト以内です。512バイトを超えると，ファイルが存在しないものと見なされます。

改行だけの行も有効です。

コメントは定義できません。

0バイトの場合，ファイルが存在しないものと見なされます。

接続するFTPクライアントによっては，応答メッセ−ジの形式に制限がある場合があります。接続するFTPクライアントが認識可能な形式でFTP接続応答メッセージファイルに記述してください。

3.14.2　表示されるFTP接続応答メッセージ

表示されるFTP接続応答メッセージを次に示します。

定義ファイル（FtsBanner.ini）でDisplayをOFFに設定し，FTP接続応答メッセージファイル（FtsBanner.txt）が存在しない場合，FTP接続応答メッセージは次のようになります。

FTP接続応答メッセージファイル（FtsBanner.txt）が存在する場合，FTPのプロトコル仕様に従って，FTP接続応答メッセージは，次のようになります。

ファイルの内容が1行の場合には，行の先頭に応答コード「220 」が付加されます。

ファイルの内容が複数行の場合には，最初の行の先頭に「220- 」，最後の行の先頭に「220 」，および最初と最後以外の行の先頭に5個の半角スペースが付加されます。

FTP接続応答メッセージの例を次に示します。

FTP接続応答メッセージファイル（FtsBanner.txt）の内容：

FTP接続応答メッセージ：

3.15　 IPv6環境での使用

IPv6アドレスを使用してファイルを伝送できます。

IPv6アドレスでファイル伝送するには，定義情報をあらかじめ登録しておきます。

3.15.1　インターネットプロトコルバージョンを登録する

次のように，定義ファイルを作成し，定義情報を記述してください。

(1)　定義ファイルの作成

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥IPversion.ini

(2)　定義ファイルの内容

次のように，Windowsの初期化ファイル（.ini）の形式で記述してください。

指定できるセクション，キー，および値を次の表に示します。

表3‒19　定義ファイル（IPversion.ini）の定義内容

セクション

キー

値

定義内容

[address_family_S]

IPv4

ON|OFF

≪ON≫

FTPクライアントから接続を受け付けるときにFTPサーバ側でIPv4を使用するかどうかを指定します。

ON：使用します。

OFF：使用しません。

IPv6

ON|OFF

≪OFF≫

FTPクライアントから接続を受け付けるときにFTPサーバ側でIPv6を使用するかどうかを指定します。

ON：使用します。

OFF：使用しません。

[address_family_C]

IPv4

ON|OFF

≪ON≫

FTPサーバに接続するときにFTPクライアント側でIPv4を使用するかどうかを指定します。

ON：使用します。

OFF：使用しません。

IPv6

ON|OFF

≪OFF≫

FTPサーバに接続するときにFTPクライアント側でIPv6を使用するかどうかを指定します。

ON：使用します。

OFF：使用しません。

Priority

IPv4|IPv6

≪IPv4≫

FTPサーバに接続するときにFTPクライアント側で優先するインターネットプロトコルバージョンを指定します。

IPv4：IPv4を優先します。

IPv6：IPv6を優先します。

この定義は，次の場合に接続するインターネットプロトコルバージョンをどちらにするか選択するときに使用します。

FTPクライアントの発信元アドレスを指定しない場合

伝送カードの相手ホスト名にホスト名を指定し，そのホスト名にIPv4，IPv6の両方のIPアドレスが定義されている。

FTPクライアントの発信元アドレスを指定する場合

ftstranコマンドの/Hオプション，カスタムジョブでのクライアントホスト名の入力フィールドにホスト名を指定し，そのホスト名にIPv4，IPv6の両方のIPアドレスが定義されている。

[address_family_L]

Use

IPv4|IPv6

≪IPv4≫

JP1/File Transmission Server/FTP Logサービスが，JP1/File Transmission Server/FTP ServerサービスおよびJP1/File Transmission Server/FTP Clientサービスと接続するときに使用するインターネットプロトコルバージョンを指定します。

IPv4：IPv4を使用します。

IPv6：IPv6を使用します。

(3)　注意事項

定義ファイルがない場合，インターネットプロトコルバージョンの選択は無効になります。その場合，FTPサーバ側およびFTPクライアント側で仮定される値は，IPv4=ON，IPv6=OFFになります。

FTPサーバ側でIPv4=OFF，IPv6=OFFを定義した場合，定義が存在しないものと見なされます。この場合，IPv4=ON，IPv6=OFFが仮定されます。

FTPクライアント側でIPv4=OFF，IPv6=OFFを定義した場合，定義が存在しないものと見なされます。この場合，IPv4=ON，IPv6=OFFが仮定されます。

4　JP1/FTPの運用管理

運用管理コンソールは，ほかのJP1/FTPの定義情報の確認や，伝送履歴の参照ができます。この章では，運用管理コンソールの操作方法を説明します。

4.1　運用管理コンソールの設定

運用管理機能を使用するには，管理するホストと管理対象となるホストで，それぞれプログラムを起動します。なお，運用管理コンソールは，管理者で起動してください。

管理するホスト：運用管理コンソールを起動する

管理するホストで起動します。リモートまたはローカルで動作するJP1/FTPサーバの伝送履歴の参照や，各定義情報の登録・更新・参照ができます。

運用管理コンソールの起動方法

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［運用管理コンソール］を選択する。

運用管理コンソール画面が表示されます。運用管理コンソール画面を次の図に示します。

図4‒1　運用管理コンソール画面

［編集］−［管理ホスト一覧］：「4.1.1 管理対象ホストを追加する」

［表示］−［履歴表示件数］：

履歴情報画面に表示する履歴件数を設定します。［履歴表示件数］ダイアログボックスが表示されますので，表示したい履歴件数を1〜10,000件の範囲で指定します。

ツリー画面：

管理対象ホストと，各情報の一覧が表示されます。表示切り替えタブで，ホストごと，機能ごとの表示に切り替えられます。

管理対象のホストが増え，ツリー画面に表示し切れない場合は，選択したホストの前後4つまでの情報が表示されます。

リスト画面：

ツリー画面で選択した情報の一覧が表示されます。表示切り替えタブで，各機能の表示に切り替えられます。

詳細画面：

リスト画面で選択した情報の詳細が表示されます。ただし，定義ユティリティの場合は，何も表示されません。

管理対象ホスト：運用管理エージェントを起動する

運用管理エージェントが動作するホストで起動します。

管理エージェントの起動方法

運用管理コンソールで管理する管理エージェントは，サービスの「JP1/File Transmission Server/FTP Agent」を開始します。サービスの起動については，「2.3 サービスの起動・終了」を参照してください。

注意事項

運用管理コンソールと運用管理エージェントとの間で，JP1/FTPのバージョンが異なっていても，運用管理機能は使用できます。

運用管理コンソールと運用管理エージェントとの間で，IPアドレスの変換が行われる環境では，運用管理機能を使用できません。

運用管理エージェント側では，物理ホスト（hostnameコマンドで返るホスト）に対応するIPアドレスを，運用管理コンソールから接続可能なIPアドレスにする必要があります。なお，運用管理エージェント側が複数のIPアドレスを持つ環境では，意図するIPアドレスが使用されないときがあります。その場合，次の定義情報をあらかじめ登録しておくことで，使用するIPアドレスを指定できます。この登録情報は，設定後に起動したJP1/File Transmission Server/FTP Agentサービスに対して有効になります。

次のパス名で定義ファイルを作成してください。

JP1/FTPのインストールディレクトリ¥manager¥agent¥jvmoptions.txt

次のように記述してください。

-Djava.rmi.server.hostname=運用管理エージェント側のIPアドレス

4.1.1　管理対象ホストを追加する

運用管理コンソールから，管理するホストを設定します。

運用管理コンソールで，［編集］−［管理ホスト一覧］を選択する。

［管理ホスト定義情報の編集］ダイアログボックスが表示されます。

図4‒2　［管理ホスト定義情報の編集］ダイアログボックス

追加する管理対象ホストのアドレスと表示名をコンマ区切りの形式で指定する。

ホストアドレス［，表示名［，ポート番号］］

ホストアドレス

管理対象ホストのホスト名称，またはIPアドレスを指定します。

この項目は省略できません。

表示名((0〜15バイトの文字列))

管理対象ホストとして，運用管理コンソール画面に表示される任意の表示名を指定します。

この項目は省略できます。省略した場合は，ホストアドレスで指定したものが表示されます。

ポート番号

管理対象ホストのポート番号を指定します。

ポート番号は省略できます。省略した場合は，ローカルホストのftsagentのポート番号が仮定されます。

ホストアドレスまたは表示名に「,（コンマ）」または「"（引用符）」が含まれる場合

ホストアドレスまたは表示名を「"（引用符）」で囲んでください。

（例）表示名「aaa,bbb」を指定する場合→myhost,"aaa,bbb"，20252

（例）表示名「aaa"bbb」を指定する場合→myhost,"aaa""bbb"，20252

複数のホストを登録する場合は，手順2を繰り返す。

［変更］をクリックする。

入力したホスト名が，ツリー画面に表示されます。

4.1.2　管理対象ホストを削除する

運用管理コンソールで，［編集］−［管理ホスト一覧］を選択する。

［管理ホスト定義情報の編集］ダイアログボックスが表示されます。

削除する管理対象ホストをドラッグで指定し，［Delete］キーを押す。

［変更］をクリックする。

そのほかの編集方法

管理対象ホストの情報は，JP1/FTPのインストールディレクトリ¥manager¥console¥hostdef.csvファイルにcsv形式（コンマ区切り）で保存されています。このファイルは，メモ帳などのテキストエディターで編集できます。テキストエディターで編集した情報を有効にするには，運用管理コンソールを再起動する必要があります。

4.2　運用管理コンソールの各画面構成と機能

運用管理コンソールは，選択した情報によって表示される内容が異なります。以降に，各情報を表示する画面を紹介します。

4.2.1　定義ユティリティ画面

運用管理コンソールから，他ホストの定義ユティリティを表示した例を，次の図に示します。また，定義ユティリティ画面で使用できる機能を紹介します。

図4‒3　定義ユティリティ画面

[図データ]またはツリー画面で右クリック：ホストの情報を開く

[図データ]またはツリー画面で右クリック：ホストの情報をコピーする

[図データ]またはツリー画面で右クリック：コピーした情報をペーストする

[図データ]またはリスト画面で右クリック：定義情報を変更する

[図データ]またはリスト画面で右クリック：最新の情報に更新する

注意事項

管理対象として設定しているホストのうち，WindowsのホストとUNIXのホスト間では，定義情報のコピーはできません。

07-50より前のバージョンから07-50以降のバージョンにコピーすると，ファイルのパス名に半角スペースを入力できなくなります。

4.2.2　ログインユーザの登録画面

運用管理コンソールから，他ホストのログインユーザの登録状況を表示した例を，次の図に示します。また，ログインユーザの登録画面で使用できる機能を紹介します。

図4‒4　ログインユーザの登録画面

[図データ]またはツリー画面で右クリック：ホストの情報を開く

[図データ]またはツリー画面で右クリック：ログインユーザの全定義情報をコピーする

[図データ]またはツリー画面，リスト画面で右クリック：コピーしたログインユーザ情報をペーストする

[図データ]またはリスト画面で右クリック：ログインユーザを新規に登録する

[図データ]またはリスト画面で右クリック：指定したログインユーザの登録内容を変更する

[図データ]またはリスト画面で右クリック：指定したログインユーザを削除する

[図データ]またはリスト画面で右クリック：指定したログインユーザの情報をコピーする

[図データ]またはリスト画面で右クリック：最新の情報に更新する

ツリー画面で右クリック：ログインユーザの情報をテキスト出力する

注意事項

［登録］または［変更］の実行中に［キャンセル］をクリックした場合，「キャンセルしました」というメッセージが表示されますが，実際には登録や変更が完了していることがあります。

管理対象として設定しているホストのうち，WindowsのホストとUNIXのホスト間では，ログインユーザ情報のコピーはできません。

4.2.3　自動起動プログラム画面

運用管理コンソールから，他ホストの自動起動プログラムの登録状況を表示した例を，次の図に示します。また，自動起動プログラム画面で使用できる機能を紹介します。

図4‒5　自動起動プログラム画面（ファイル対応）

[図データ]またはツリー画面で右クリック：ホストの情報を開く

[図データ]またはツリー画面で右クリック：自動起動プログラムの全定義情報をコピーする

[図データ]またはツリー画面，リスト画面で右クリック：コピーした情報をペーストする

[図データ]またはリスト画面で右クリック：自動起動プログラムを新規に登録する

[図データ]またはリスト画面で右クリック：自動起動プログラムの登録内容を変更する

[図データ]またはリスト画面で右クリック：自動起動プログラムを削除する

[図データ]またはリスト画面で右クリック：指定した自動起動プログラムの情報をコピーする

[図データ]またはリスト画面で右クリック：最新の情報に更新する

ツリー画面で右クリック：自動起動プログラムの情報をテキスト出力する

注意事項

［登録］または［変更］の実行中に［キャンセル］をクリックした場合，「キャンセルしました」というメッセージが表示されますが，実際には登録や変更が完了していることがあります。

管理エージェントがUNIXの場合，自動起動プログラムを登録する際にログインユーザ名が登録されているかどうかの確認はされません。

管理対象として設定しているホストのうち，WindowsのホストとUNIXのホスト間では，自動起動プログラムの情報のコピーはできません。

4.2.4　伝送情報の登録画面

運用管理コンソールから，他ホストの伝送情報の登録状況を表示した例を，次の図に示します。また，伝送情報の登録画面で使用できる機能を紹介します。

図4‒6　伝送情報の登録画面

[図データ]またはツリー画面で右クリック：ホストの情報を開く

[図データ]またはツリー画面で右クリック：伝送情報の全定義情報をコピーする

[図データ]またはツリー画面，リスト画面で右クリック：コピーした情報をペーストする

[図データ]またはリスト画面で右クリック：伝送情報を新規に登録する

[図データ]またはリスト画面で右クリック：伝送情報の登録内容を変更する

[図データ]またはリスト画面で右クリック：伝送情報を削除する

[図データ]またはリスト画面で右クリック：指定した伝送情報をコピーする

[図データ]またはリスト画面で右クリック：最新の情報に更新する

ツリー画面で右クリック：伝送情報をテキスト出力する

注意事項

［登録］または［変更］の実行中に［キャンセル］をクリックした場合，「キャンセルしました」というメッセージが表示されますが，実際には登録や変更が完了していることがあります。

管理対象として設定しているホストのうち，WindowsのホストとUNIXのホスト間では，伝送情報のコピーはできません。

4.2.5　履歴情報の表示画面

運用管理コンソールから，他ホストの履歴情報を表示した例を，次の図に示します。また，履歴情報の表示画面で使用できる機能を紹介します。

図4‒7　履歴情報の表示画面

[図データ]またはツリー画面で右クリック：ホストの情報を開く

[図データ]またはリスト画面で右クリック：すべての履歴情報を表示する

[図データ]またはリスト画面で右クリック：特定の履歴情報を表示する

[図データ]またはリスト画面で右クリック：プロトコルトレースを表示する

[図データ]またはリスト画面で右クリック：最新の情報に更新する

ツリー画面で右クリック：履歴情報をテキスト出力する

注意事項

同時刻の伝送履歴がある場合，運用管理コンソールの履歴情報画面の表示と［履歴情報の一覧］ウィンドウでは，表示される順序が異なることがあります。

Windowsの［スタート］メニューから［プログラム］−［JP1_File Transmission Server_FTP］−［履歴情報の表示］を選択した画面からプロトコルトレースを表示する場合と異なり，該当する伝送のトレースがある場合でも，すべてのトレースが表示されます。

10-00より前のバージョンの運用管理エージェントは4ギガバイト以上の伝送サイズに対応していません。このため，10-00より前のバージョンの運用管理エージェントと接続している場合，伝送サイズが4ギガバイト以上になった伝送履歴を参照すると，実際の伝送サイズより小さい値になります。

4.3　運用管理コンソールのメニュー実行例

運用管理コンソールから各情報を登録したり，編集したりする操作は，各画面で共通しています。4つのメニュー実行例を示しますので，操作の参考にしてください。

4.3.1　ログインユーザ情報を登録する例

情報を登録する例として，東京本社にログインユーザ情報を登録する方法を次に示します。

ツリー画面から「東京本社」をダブルクリックする。

東京本社の下にある「ログインユーザの登録」を選択し，[図データ]をクリックする。

リスト画面に東京本社に登録されているログインユーザの一覧が表示されます。

リスト画面上の[図データ]をクリックする。

ログインユーザを登録するためのダイアログボックスが表示されます。リスト画面でログインユーザの情報を選択した状態で開くと，選択したログインユーザの情報が表示されます。表示された情報をひな形にして，新規登録することもできます。

図4‒8　ログインユーザを登録するためのダイアログボックス

ログインユーザ情報を入力し，［登録］をクリックする。

登録する内容については，「3.2.1 ログインユーザを登録する」を参照してください。

［閉じる］をクリックするまで，続けて複数のログインユーザ情報を登録できます。

［閉じる］をクリックする。

ログインユーザの変更，削除

同様の手順で，ログインユーザ情報の変更や削除ができます。

変更：ログインユーザを指定して[図データ]をクリックする。

削除：ログインユーザを指定して[図データ]をクリックする。

4.3.2　伝送情報を配布（コピー）する例

情報をコピーする例として，東京本社の伝送情報を，横浜支社，大阪支社，福岡支社の3つの支社に配布する（同一情報があった場合は上書きする）方法を次に示します。

ツリー画面から「東京本社」をダブルクリックする。

東京本社の下にある「伝送情報の登録」を選択し，[図データ]をクリックする。

ツリー画面から，「横浜支社」をクリックし，続けて［Shift］キーまたは［Ctrl］キーを押しながら，「大阪支社」，「福岡支社」をクリックする。

ツリー画面またはリスト画面上の[図データ]をクリックする。

情報をコピー＆ペーストするダイアログボックスが表示されます。

図4‒9　情報をコピー＆ペーストするためのダイアログボックス

［履歴情報ディレクトリを上書きする］について

この項目は，環境定義情報をコピーするときだけ有効になります。既存の履歴情報ディレクトリを上書きする場合だけ，チェックします。

［同一項目は上書きする］を指定し，［実行］をクリックする。

コピー＆ペーストが終了すると，実行結果と［詳細］が表示されます。［詳細］をクリックすると，コピーした情報やエラー情報が参照できます。

［閉じる］をクリックする。

4.3.3　履歴情報を表示する例

情報を表示する例として，東京本社の履歴情報を表示する方法を次に示します。

ツリー画面の下部にある［機能］タブをクリックする。

ツリー画面の表示方法が機能ごとの表示に切り替わります。

ツリー画面から［履歴情報の表示］をダブルクリックする。

履歴情報の下にある「東京本社」を選択し，[図データ]をクリックする。

リスト画面に履歴情報の一覧が表示されます。

特定の履歴情報だけを表示するには

リスト画面上の[図データ]をクリックし，表示されるダイアログボックスに，表示したい情報の条件を指定します。

図4‒10　特定の情報を表示するダイアログボックス

4.3.4　複数の定義情報をテキスト出力する例

定義情報をテキスト出力する例として，横浜支社，大阪支社，福岡支社の各情報を，テキスト出力する方法を次に示します。テキスト出力は，テキスト出力またはテキスト追加出力のどちらかを指定できます。

なお，出力されるテキストのフォーマットは，インストール時にサンプルのフォーマットが設定されています。フォーマットファイルは使いやすい形に変更できます。詳しくは，「付録E 定義情報を出力するフォーマットファイルについて」を参照してください。

ツリー画面から「横浜支社」をクリックし，続けて［Shift］キーまたは［Ctrl］キーを押しながら，「大阪支社」，「福岡支社」をクリックする。

右クリックし，表示されるメニューから［テキスト出力］を選択する。

［情報のテキスト出力／テキスト追加出力］ダイアログボックスが表示されます。

図4‒11　［情報のテキスト出力／テキスト追加出力］ダイアログボックス

テキスト出力先ディレクトリを指定し，［テキスト出力］または［テキスト追加出力］をクリックする。

［テキスト出力］

指定したファイルに定義情報を出力します。既存のファイルを指定した場合，元のファイル内容は上書きされます。

［テキスト追加出力］

指定したファイルの最終行以降に定義情報を出力します。

テキスト出力状況が表示されます。

［閉じる］をクリックする。

テキスト出力のファイル名

各情報の出力ファイル名を次の表に示します。

表4‒1　テキスト出力ファイル名

情報種別

ファイル名※1

ユーザ情報※2

ホスト表示名_user.txt

ファイル対応の自動起動プログラム情報

ホスト表示名_autof.txt

ディレクトリ対応の自動起動プログラム情報

ホスト表示名_autod.txt

伝送情報

ホスト表示名_tran.txt

履歴情報

ホスト表示名_hist.txt

注※1

ファイル名のホスト表示名部分に，ファイル名として使用できない文字（［¥／：；，＊？”＜＞｜］）がある場合は，該当文字を「＃」で置き換えたものをファイル名とします。

注※2

対象ホストがUNIXの場合は，出力できません。

5　JP1プログラムとの連携

この章では，JP1/FTPとJP1プログラムを連携させて使用するための設定や，操作方法について説明します。

5.1　JP1/AJS3との連携

JP1/AJS3と連携して，スケジュールによるファイル伝送ができます。

JP1/AJS3と連携するための設定と操作方法を説明します。

5.1.1　JP1/AJS3と連携する場合のシステム構成

必要なプログラム

次のプログラムをJP1/FTPと同じマシンにインストールします。

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agent

JP1/AJS3 - View

JP1/FTPとJP1/AJS3 - Viewを別のマシンにインストールする場合

JP1/FTPとJP1/AJS3 - Viewとは，別のマシンにインストールしても動作します。別のマシンにした場合，必要なファイルをJP1/AJS3 - Viewのマシンにコピーする必要があります。詳しくは，「5.1.2 JP1/AJS3と連携するための設定をする」を参照してください。

図5‒1　JP1/AJS3と連携する場合のシステム構成例

5.1.2　JP1/AJS3と連携するための設定をする

JP1/FTPをJP1/AJS3と連携させるために，JP1/AJS3で次の設定をします。

JP1/FTPのカスタムジョブの登録

JP1/FTPのカスタムジョブをJP1/AJS3で使用するために，JP1/AJS3に登録します。

JP1/FTPの伝送情報のコピー

ジョブを定義するホストと実行するホストが異なる場合は，実行するホストの伝送情報を，ジョブを定義するホストにコピーします。

(1)　JP1/FTPのカスタムジョブの登録

Windowsの［スタート］メニューから［プログラム］−［JP1_Automatic Job Management System 3 - View］−［カスタムジョブ登録］を選択する。

［カスタムジョブの登録］ダイアログボックスが表示されます。

［新規登録］をクリックする。

［カスタムジョブ登録情報］ダイアログボックスが表示されます。

各項目を設定し，［OK］をクリックする。

カスタムジョブが登録されます。［カスタムジョブ登録情報］ダイアログボックスと各設定項目を次に示します。

図5‒2　［カスタムジョブ登録情報］ダイアログボックス

表5‒1　［カスタムジョブ登録情報］ダイアログボックスの設定項目

項目

設定内容

名前

((1〜8バイト以内の文字列))

《空白》

任意のカスタムジョブ名を指定します。この項目は省略できません。

コメント

((0〜40バイト以内の文字列))

《空白》

任意のコメントを指定します。コメントには，「/」と空白文字は使用できません。

定義プログラム

次の定義プログラム名を指定します。

JP1/FTPのインストールディレクトリ¥FTS_CARD.EXE（固定）

定義ホスト上の定義プログラムを指定してください。

定義ホストにJP1/FTPがインストールされていない場合は，「(2)　定義プログラムのコピーと設定」に従って，必要なファイルをコピーします。

実行プログラム

次の実行プログラム名を指定します。

JP1/FTPのインストールディレクトリ¥FTS_JPCS.EXE（固定）

実行ホスト上の実行プログラムを指定してください。

実行プログラムが複数のJP1/AJS3 - Agentにあって，インストールパスが異なる場合は，「$xxx$¥実行ファイル名（xxxは変数）」と指定します。このとき，JP1/AJS3 - Agentホストで変数を登録（定義）する必要があります。登録方法については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」を参照してください。

なお，実行プログラムの戻り値は，ftstranコマンドと同じです。ftstranコマンドの戻り値を参照してください。

バージョン

0600（固定）

クラス名

JP1FTP（固定）

ジョブ種別

PCジョブ

(2)　定義プログラムのコピーと設定

定義ホストにJP1/FTPがインストールされていない場合は，次の設定をしてください。

次のファイルをJP1/AJS3 - Viewがインストールされているマシンにコピーする。

コピー先は，必ず次のディレクトリにしてください。

定義プログラム（FTS_CARD.EXE），DLLファイル（ftslang.dll）

コピー先：［カスタムジョブ登録情報］ダイアログボックスの「定義プログラム」で指定したディレクトリ

環境設定ファイル（ftscard.ini）

コピー先：C:¥Program Files¥HITACHI¥FTSFTP

DLLファイル（Fts_card_*.dll，Fts_cmn_msg_*.dll）

コピー先：C:¥Program Files¥HITACHI¥FTSFTP¥Lang

コピーした環境設定ファイルで，定義プログラムの動作環境を設定する。

指定できるセクション，キー，および値を次の表に示します。

表5‒2　定義ファイル（ftscard.ini）の定義内容

セクション

キー

値

定義内容

[Language]

LangType

0x0409| 0x0411

≪0x0411≫

使用する言語を指定します。

0x0409：英語

0x0411：日本語

5.1.3　スケジュール伝送をする

スケジュール伝送をするには，まずジョブネットを作成してからジョブネットにスケジュール登録をします。

(1)　ジョブネットの作成

Windowsの［スタート］メニューから［プログラム］−［JP1_Automatic Job Management System 3 - View］の［ジョブシステム運用］を選択し，ログインする。

［JP1/AJS3 - View］ウィンドウが表示されます。

［編集］−［新規作成］−［ジョブネット］を選択し，ジョブネットを作成する。

各項目を設定し，［OK］をクリックする。

設定例を次の図に示します。詳しくは，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」を参照してください。

図5‒3　［詳細定義−［ジョブネット］］ダイアログボックス設定例

作成したジョブネットをダブルクリックする。

［ジョブネットエディタ］ウィンドウが表示されます。

［排他編集］がチェックされた状態にする。

アイコンリストから必要なジョブアイコンをマップエリアにドラッグする。

JP1/FTPのアイコンは［カスタムジョブ］タブの中の[図データ]です。

［詳細定義−［Custom Job］］ダイアログボックスが表示されます。

各項目を設定する。

設定例を次の図に示します。詳しくは，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」を参照してください。

図5‒4　［詳細定義−［Custom Job］］ダイアログボックス設定例

［詳細］をクリックする。

［伝送カードの指定］ダイアログボックスが表示されます。［伝送の登録／実行］ダイアログボックスまたは運用管理コンソールで登録した伝送カードの内容がリストに表示されます。

各項目を設定し，［OK］をクリックする。

［伝送カードの指定］ダイアログボックスの設定例と，設定項目を次の図に示します。

図5‒5　［伝送カードの指定］ダイアログボックス設定例

表5‒3　［伝送カードの指定］ダイアログボックスの設定項目

項目

設定内容

伝送カード名

リストから伝送カードを指定して，［選択］をクリックするか，または伝送カードをダブルクリックします。伝送カード名に半角スペースが含まれる場合，そのカードは指定できません。

伝送カードの内容を確認したい場合は，伝送カードを指定して［詳細］をクリックします。

なお，ここで表示される伝送カードは，定義ホスト上のJP1/FTPで設定されている伝送カードです。次の場合，該当する伝送カードのリストは表示されません。伝送カード名を直接入力してください。

ジョブを定義するホストとジョブを実行するホストが異なる。

JP1/FTPがインストールされていない。

クライアントホスト名

FTPクライアントの発信元IPアドレスに設定するホスト名（物理ホストまたは論理ホスト）またはIPアドレスを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。

FTPクライアントでの自IPアドレスの指定を有効にした場合，このオプションでの指定がFTPクライアントの自IPアドレスになります。オプションを指定しなかった場合，FTPクライアントの物理ホストが仮定されます。

FTPクライアントでの自IPアドレスの指定を無効にした場合，FTPクライアントの自IPアドレスは，OSが自動的に割り当てるアドレスになります。

FTPクライアントでの自IPアドレスの指定を有効にする定義については，「3.11 複数IPアドレス環境での使用」を参照してください。

伝送終了情報格納ファイル名

((0〜259バイトの文字列))

伝送結果の出力先ファイル名を指定します。ファイル名はフルパスで指定してください。この項目は省略できます。

出力形式

伝送結果の出力ファイルの形式を指定します。

バイナリを指定した場合，FTS_FTP_API_DATA_EX構造体，FTS_FTP_API_RETDATA_EX構造体の連続したデータを出力します。

必要に応じて，PCジョブなどの設定をし，ジョブの関連づけをする。

設定例を次の図に示します。

図5‒6　ジョブネット設定例

［ジョブネットエディタ］ウィンドウを閉じる。

(2)　スケジュール登録をする

［JP1/AJS3 - View］ウィンドウのリストエリアから，スケジュール登録するジョブネットを選択し，［編集］−［スケジュール］を選択する。

［スケジュールの設定］ダイアログボックスが表示されます。

各項目を設定し，［OK］をクリックする。

設定例を次の図に示します。詳しくは，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」を参照してください。

図5‒7　［スケジュールの設定］ダイアログボックス設定例

［JP1/AJS3 - View］ウィンドウのリストエリアから，実行登録するジョブネットを選択し，［操作］−［実行登録］を選択する。

［実行登録］ダイアログボックスが表示されます。

各項目を設定し，［OK］をクリックする。

設定例を次の図に示します。詳しくは，マニュアル「JP1/Automatic Job Management System 3 連携ガイド」を参照してください。

図5‒8　［実行登録］ダイアログボックス設定例

5.2　JP1/IMとの連携

JP1/IMと連携して，JP1/FTPのサービスの開始，停止，伝送の終了（正常，警告，異常）をJP1/IMの［イベントコンソール］画面で集中監視します。また，JP1/IMの［統合機能メニュー］画面から，JP1/FTPのプログラムを直接起動できます。

5.2.1　JP1/IMと連携する場合のシステム構成

必要なプログラム

次のプログラムを，JP1/FTPと同じマシンにインストールします。

JP1/Base

また，JP1/FTPを監視するマシンには，次のプログラムをインストールします。

JP1/IM - Manager

JP1/IM - View

JP1/Base

図5‒9　JP1/IMと連携する場合のシステム構成例

5.2.2　JP1/IMと連携するための設定をする

［環境定義］ダイアログボックスで［JP1/IMイベントの発行］をチェックし，［OK］をクリックする。

［環境定義］ダイアログボックスについては，「3.1 JP1/FTPの環境定義」を参照してください。

5.2.3　サービスを起動する

JP1/Base，JP1/IM，およびJP1/FTPのサービスを起動します。サービスを起動する手順を次に示します。なお，すでにJP1/FTPのサービスが起動している場合は，一度停止させてください。

Windowsの［スタート］メニューから，［コントロールパネル］−［管理ツール］−［サービス］を選択する。

次のサービスを右クリックし，ポップアップメニューから［開始］を選択する。

JP1/Baseのイベントサービス：JP1/Base Event

JP1/IMのサービス：JP1/IM-Manager

JP1/FTPのサービス

サービスが起動します。以後，JP1/FTPのサービスの状態やファイル伝送の状態がJP1イベントによって通知されます。

JP1イベントが発行できない場合

JP1/FTPのサービスとJP1/Baseイベントサービスの起動状態によってJP1イベントが発行できない場合があります。この場合は，コマンドプロンプトで次の内容を入力し，依存関係を結んでください。

ftsdpnd.exe /D BASE

依存関係を解除する場合は，コマンドプロンプトで次の内容を入力します。

ftsdpnd.exe /I BASE

5.2.4　JP1/IMで伝送結果を監視する

JP1/IMの［イベントコンソール］画面で，伝送結果を監視します。

Windowsの［スタート］メニューから，［プログラム］−［JP1_Integrated Management - View］−［統合ビュー］を選択する。

［ログイン］画面が表示されます。

ログイン画面で，ユーザー名，パスワード，および接続ホスト名を入力する。

［OK］をクリックする。

［イベントコンソール］画面が表示されます。

JP1/FTPが出力するJP1イベントの一覧とその属性については，「付録D JP1イベント」を参照してください。

6　コマンド

この章では，JP1/FTPが提供するコマンドについて説明します。

コマンド一覧

JP1/FTPで使用できるコマンドの一覧を次に示します。

表6‒1　JP1/FTPで使用できるコマンド

機能

コマンド名

伝送を実行する

ftstran

伝送情報を登録・変更・削除・表示する

ftsregc

履歴情報を表示する

ftshistory

定義情報を保存する

ftssave

定義情報を復元する

ftsload

コマンドの詳細

コマンドの格納先

JP1/FTPのインストールディレクトリ

デフォルトは次のとおりです。

OSのインストールドライブ:¥Program Files(x86)¥Hitachi¥FTSFTP

ftstran−伝送の実行−

形式

ftstran 伝送カード名[/L ファイル名][/N ファイル名][/E ファイル名][/M [B|T]][/H ホスト名][伝送オプション オプション引数]

機能

指定した伝送カード名でファイル伝送を実行します（選択実行）。または，指定した伝送カードの内容を変更して，伝送を実行します（オンデマンド実行）。

このコマンドは，一般ユーザ権限で実行可能です。

引数

伝送カード名((1〜20バイトの文字列))

［伝送情報の登録／実行］で登録した伝送カード名を指定します。

/L ファイル名((1〜259バイトの文字列))

ftstranコマンド終了時，指定のファイルに次の情報をログ出力します。

コマンドの終了時刻，戻り値，メッセージ，伝送カード名，ローカルファイル名，リモートファイル名

コマンドを実行したユーザに書き込み権限があるファイル名を指定してください。このオプションを省略した場合，ログは出力されません。

ファイル名に相対パスを指定した場合は，コマンドを実行したディレクトリからの相対パスとなります。

ファイルのサイズが1MBを超えたら，「ファイル名」を「ファイル名_old」にリネームします。すでに「ファイル名_old」がある場合は，「ファイル名_old」を削除してからリネームします。

ファイルに格納できるログ件数は，

1MB/(伝送カード名長+ローカルファイル名長+リモートファイル名長+122)+1

となります。

/N ファイル名((1〜259バイトの文字列))

伝送正常終了時に結果を出力するファイル名を指定します。コマンドを実行したユーザに書き込み権限があるファイル名を指定してください。このオプションを省略した場合，伝送正常終了時に伝送結果は出力されません。

ファイル名に相対パスを指定した場合は，コマンドを実行したディレクトリからの相対となります。

同名のファイルが存在する場合は，上書きされます。

/E ファイル名((1〜259バイトの文字列))

伝送異常終了時に結果を出力するファイル名を指定します。コマンドを実行したユーザに書き込み権限があるファイル名を指定してください。このオプションを省略した場合，伝送異常終了時に伝送結果は出力されません。

ファイル名に相対パスを指定した場合は，コマンドを実行したディレクトリからの相対となります。

同名のファイルが存在する場合は，上書きされます。

/M [B|T]

出力形式を指定します。

B：BINARY形式（FTS_FTP_API_DATA_EX構造体，FTS_FTP_API_RETDATA_EX構造体の連続したデータ）

T：テキスト形式

/H ホスト名((1〜256バイトの文字列))

FTPクライアントの発信元IPアドレスに設定するホスト名（物理ホストまたは論理ホスト）またはIPアドレスを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。

FTPクライアントでの自IPアドレスの指定を有効にした場合，このオプションでの指定がFTPクライアントの自IPアドレスになります。オプションを指定しなかった場合，FTPクライアントの物理ホストが仮定されます。

FTPクライアントでの自IPアドレスの指定を無効にした場合，FTPクライアントの自IPアドレスは，OSが自動的に割り当てるアドレスになります。

FTPクライアントでの自IPアドレスの指定を有効にする定義については，「3.11 複数IPアドレス環境での使用」を参照してください。

伝送情報オプション オプション引数

指定した伝送カードの伝送情報を一部変更して伝送したい場合に，オプションを指定して伝送します（オンデマンド実行）。伝送情報オプションについては，「6. コマンド」の「ftsregc−伝送情報の登録・変更・削除・表示−」を参照してください。また，伝送情報オプションのオプション引数については，「3.4.1 伝送情報を伝送カードに登録する」を参照してください。

戻り値（10進数）

0

正常終了

10XXXXX

伝送終了情報格納ファイルオープン時の異常による警告付き正常終了

XXXXXには，CreateFile関数の拡張エラー情報が入ります。

11XXXXX

伝送終了情報格納ファイル出力時の異常による警告付き正常終了

XXXXXには，WriteFile関数の拡張エラー情報が入ります。

12XXXXX

JP1/FTPとのコネクション解放時の異常による警告付き正常終了

XXXXXには，fts_ftp_close関数の拡張エラー情報の下1バイトが入ります。

1300000

カード情報未取得による異常終了

50XXXXX

fts_ftp_open_ex( )の異常による異常終了

XXXXXには，fts_ftp_open_ex関数の拡張エラー情報の下1バイトが入ります。

51XXXXX

fts_ftp_syn_request_ex( )の異常による異常終了

XXXXXには，fts_ftp_syn_request_ex関数の拡張エラー情報の下1バイトが入ります。

52XXXXX

WSAStartup( )の異常による異常終了

XXXXXには，WSAStartup関数の拡張エラー情報が入ります。

9000000

伝送の異常終了

9000001

引数指定誤りによる異常終了

9900000

異常終了（論理エラー）

表示されるメッセージについては，「8.3.1 ftstranコマンド実行時のメッセージ」を参照してください。

使用例

選択実行の例

オンデマンド実行の例

card1の伝送情報のうち，次の情報を変更して伝送する。

/TC：カード名を「card2」

/TH：接続先ホスト名を「host1」

/TT：送受信種別を「SEND（送信）」

/TY：伝送モードを「BINARY」

/TL：ローカルファイル名を「c:¥temp¥file1」

/TR：リモートファイル名を「c:¥temp¥file2」

ftsregc−伝送情報の登録・変更・削除・表示−

形式

登録

ftsregc /N [伝送カード名] [伝送情報オプション オプション引数]

変更

ftsregc /C 伝送カード名 [伝送情報オプション オプション引数]

削除

ftsregc /D 伝送カード名

表示

ftsregc /L 伝送カード名

機能

伝送情報を登録・変更・削除・表示するコマンドです。

引数

/N [伝送カード名] [伝送情報オプション オプション引数]

伝送情報の登録は，新規に伝送カードに登録する方法と，既存の伝送カードをひな形として，登録内容を書き換えて別の伝送カードとして登録する方法があります。

新規に伝送カードに登録する

ftsregc /N [伝送情報オプション オプション引数]

伝送情報オプションで指定された内容を伝送情報として新規作成します。伝送情報オプションのうち，/TC，/TH，/TU，/TT，/TY，/TL，/TRは，必ず指定してください。伝送カード名は，伝送情報オプションの/TCで指定してください。

既存の伝送カードを利用して登録する

ftsregc /N [伝送カード名] [伝送情報オプション オプション引数]

ひな形として利用する伝送カード名を指定し，変更したい伝送情報オプションを指定してください。このとき，/TCには登録する伝送カード名を必ず指定してください。

伝送情報オプションの一覧を次に示します。

表6‒2　伝送情報オプション

オプション名

オプション引数

値

/TC

カード名

((1〜20バイト))

/TH

接続先ホスト名

((1〜256バイト))

/TP

接続先ポート番号

((1〜65535))

/TU

ログインユーザ名

((1〜50バイト))

/TW

ログインパスワード

((1〜50バイト))

/TT

送受信種別

SEND：送信（上書き）するときに選択します。

RECV：受信するときに選択します。

APPE：送信（追加）するときに選択します。

SEND｜RECV｜APPE

/TY

伝送モード

ASCII：ASCIIモードでファイル伝送をします。

BINARY：BINARYモードでファイル伝送をします。

ASCII｜BINARY

/TM

圧縮モード

STREAM：ファイルを圧縮しないで伝送します。

COMPRESS：ファイルを圧縮して伝送します。

STREAM｜COMPRESS

/TK

サイズ確認

CHECK：サイズ確認をします。

UNCHECK：サイズ確認をしません。

CHECK｜UNCHECK

/TL

ローカルファイル名

((1〜259バイト))

/TR

リモートファイル名

((1〜259バイト))

/TS

正常時に起動するプログラム名

((1〜259バイト))

/TF

異常時に起動するプログラム名

((1〜259バイト))

/TX

FTPコマンド

((1〜300バイト))

/TO

コメント

((1〜80バイト))

/TA

受信時の単／複伝送

AUTO：複数ファイル伝送または単一ファイル伝送を自動切り替えします。

MULTIPLE：複数ファイル伝送をします。

SINGLE：単一ファイル伝送をします。

AUTO｜MULTIPLE｜SINGLE

それぞれのオプション引数については，「3.4.1 伝送情報を伝送カードに登録する」を参照してください。

/C カード名 [伝送情報オプション オプション引数]

指定されたカード名の伝送情報のうち，伝送情報オプションで指定されたものを変更します。

/D カード名

指定されたカード名の伝送情報を削除します。

/L カード名

指定されたカード名の伝送情報を表示します。

戻り値

0

正常終了

6100001

登録時のカード名未指定

6100002

登録時の接続ホスト名未指定

6100003

登録時のログインユーザ名未指定

6100004

登録時の送受信種別未指定

6100005

登録時の伝送モード未指定

6100006

登録時のローカルファイル名未指定

6100007

登録時のリモートファイル名未指定

6100008

既存のカード名を指定したときの異常終了

6100009

登録時のカード名未指定

6100010

カード情報登録時の異常終了

6200001

変更時のカード名未指定

6200002

変更前のカード情報取得時の異常終了

6200003

変更後のカード情報作成時の異常終了

6200004

変更前のカード情報削除時の異常終了

6200005

カード情報変更時の異常終了

6300000

ftsregc /D指定時の異常終了

6400000

ftsregc /L指定時の異常終了

6900000

コマンドラインの構文誤り

9000001

ftsregc共通の異常終了

9900001

異常終了（管理者で実行されていない）

表示されるメッセージについては，「8.3.2 ftsregcコマンド実行時のメッセージ」を参照してください。

ftshistory−履歴情報の表示−

形式

ftshistory

機能

フォーマットファイルで定義された出力形式に従って，履歴情報を表示します。

フォーマットファイルは，履歴情報の表示のテキスト出力機能で使用するフォーマットファイルを使用します。

戻り値（10進数）

0

正常終了

6400000

履歴情報の表示の失敗

9000001

引数指定誤りによる異常終了

9900001

異常終了（管理者で実行されていない）

表示されるメッセージについては，「8.3.3 ftshistoryコマンド実行時のメッセージ」を参照してください。

ftssave−定義情報の保存−

形式

ftssave ファイル名[/E][/U][/A][/T]

機能

定義情報を指定したファイル名で保存します。

引数

ファイル名

保存するファイルの名称を指定します。指定できる文字数は，1〜259バイトです。相対パスで指定した場合は，コマンドを実行したパスからの相対となります。

/E

環境情報を保存します。

/U

ログインユーザ情報を保存します。

/A

自動起動プログラム情報を保存します。

/T

伝送情報を保存します。

補足事項

/E，/U，/A，/Tをすべて省略した場合は，すべての定義情報を保存します。

コマンドでは，コメントの設定はできません。

指定したファイルがすでにある場合は，異常終了になります。

保存する情報がない場合は，警告付き正常終了になります。また，指定した定義情報に対して保存する情報がない場合は，定義情報なしとして保存します。このように登録された情報は，復元時に復元の指定はできますが，登録はされません。

このコマンドで出力したメッセージは，イベントログにも出力されます。

戻り値

0

正常終了

1

警告付き正常終了

2

異常終了

表示されるメッセージについては，「8.3.5 ftssaveコマンド実行時のメッセージ」を参照してください。

ftsload−定義情報の復元−

形式

ftsload ファイル名[/M[N|D]][/E][/U][/A][/T]

機能

保存した定義情報を復元し，JP1/FTPの環境定義をします。

引数

ファイル名

復元するファイル名称を指定します。相対パスで指定した場合は，コマンドを実行したパスからの相対となります。

/M[N|D]

復元方法を指定します。

N：元の情報を削除しない

D：元の情報を削除する

/E

環境情報を復元します。

/U

ログインユーザ情報を復元します。

/A

自動起動プログラム情報を復元します。

/T

伝送情報を復元します。

補足事項

/E，/U，/A，/Tをすべて省略した場合は，すべての定義情報を復元します。

指定した定義情報が保存ファイルにないときは，保存ファイルにある定義情報だけを復元します。

自動起動プログラムの登録情報を復元する場合，該当するユーザがなかったときは，警告付き正常終了になります。

指定した定義情報が保存ファイルに1つもない場合は，異常終了になります。

このコマンドで出力したメッセージは，イベントログにも出力されます。

戻り値

0

正常終了

1

警告付き正常終了

2

異常終了

表示されるメッセージについては，「8.3.4 ftsloadコマンド実行時のメッセージ」を参照してください。

7　APIライブラリ

この章では，ユーザプログラムとJP1/FTPを連携させるときに使用するJP1/FTP APIライブラリの使用方法，例題および関数の詳細について説明します。

ライブラリの使用方法

JP1/FTP APIライブラリは，JP1/FTPのファイル伝送機能をユーザプログラムから利用するときに使用します。

JP1/FTP APIライブラリを使用して，次のことができます。

1つのユーザプログラムから複数のホスト上（同一ホストでもよい）で動作する複数のJP1/FTPに伝送要求を登録できます。

伝送要求の登録には，同期型と非同期型があります。

同期型：伝送が終了するまで待ち，終了結果を取得できます。

非同期型：登録だけをして，あとで終了結果だけを取得できます。

関数を使用するための前提条件

JP1/FTPが提供する関数を使用するために必要なものを次に示します。

JP1/FTP APIライブラリ

コンパイラー：Visual Studio

ユーザプログラムで使用できる言語を次に示します。

C

C++

JP1/FTP APIライブラリが前提とするコンパイラーを次に示します。

表7‒1　JP1/FTP APIライブラリが前提とするコンパイラー

コンパイラー

種別

ヘッダファイル

インポートライブラリ

Visual Studio 2012

32ビット用

apihead.h

FTSFTP110.lib

64ビット用

apihead.h

FTSFTP110_x64.lib

Visual Studio 2013

32ビット用

apihead.h

FTSFTP120.lib

64ビット用

apihead.h

FTSFTP120_x64.lib

ヘッダファイルおよびインポートライブラリの格納先は，「付録A　ファイルおよびディレクトリ一覧」を参照してください。なお，Visual Studio自体をインストールできるOSは，Visual Studioの仕様に依存します。

環境設定

SERVICESの設定

JP1/FTP Clientのサービス名「ftsc」を設定します。詳しくは，「2.2.3 ポート番号を設定する」を参照してください。

HOSTSの設定

クライアント側のJP1/FTPが動作しているホストのホスト名とIPアドレスを設定します。このホスト名は接続情報構造体，伝送情報構造体で指定します。

OSのインストールディレクトリ¥system32¥drivers¥etc¥HOSTSに次の1行を追加してください。

xxx.xxx.xxx.xxx      yyyyyy

（凡例）

xxx.xxx.xxx.xxx：IPアドレス

yyyyyy：ホスト名

コーディング

JP1/FTPとのコネクション確立情報の指定

JP1/FTP Clientサービスとのコネクション確立は，fts_ftp_open_ex()の引数に接続情報構造体のアドレスを設定します。

接続情報構造体

typedef struct _FTS_FTP_API_CONN_DATA {
    char hostname[256+1];           /* ホスト名 (クライアント) */
    int priority;                   /* 優先IPバージョン */
    char reserve[1784];             /* 予約領域 */
} FTS_FTP_API_CONN_DATA;

接続情報構造体メンバの内容

hostname：JP1/FTP Clientサービスが動作しているホストのホスト名またはIPアドレスを指定します。IPアドレスの場合，IPv4またはIPv6アドレスを指定できます。NULLを指定した場合は，自ホスト名（OSのhostnameコマンドが返すホスト名：物理ホスト）が仮定されます。

FTPクライアントでの自IPアドレスの指定を有効にした場合，この引数での指定がFTPクライアントの自IPアドレスになります。

NULLを指定した場合は，FTPクライアントの物理ホストが仮定されます。

FTPクライアントでの自IPアドレスの指定を無効にした場合，FTPクライアントの自IPアドレスは，OSが自動的に割り当てるアドレスになります。FTPクライアントでの自IPアドレスの指定を有効にする定義については，「3.11 複数IPアドレス環境での使用」を参照してください。

priority：優先するインターネットプロトコルバージョンを指定します。

FTS_AF_INET：IPv4を優先します。

FTS_AF_INET6：IPv6を優先します。

上記以外の場合，FTS_AF_INETを仮定します。

reserve：予約領域です。「¥0」で初期化してください。

注意事項

char型の変数値の最後は，「¥0」にしてください。

伝送情報の指定

ファイル伝送要求の登録は，fts_ftp_syn_request_ex(),fts_ftp_asyn_request_ex()の引数に登録済みの伝送カード名や伝送情報構造体のアドレスを設定します。

カード名称による伝送要求の登録

［伝送の登録／実行］で登録した伝送カード名を指定することで，伝送要求を登録できます。

伝送情報構造体による伝送情報の指定

伝送に必要な情報を指定することで，伝送要求を登録できます。

伝送情報構造体

typedef struct _FTS_FTP_API_DATA_EX {
    char cardname[20+1];            /* カード名称 */
    char host[256+1];               /* 相手ホスト名 */
    unsigned int portnum;           /* ポート番号 */
    char username[50+1];            /* 相手ユーザ名 */
    char password[50+1];            /* パスワード */
    int type;                       /* 伝送モード */
    int mode;                       /* 圧縮モード */
    int cmd;                        /* 送受信種別 */
    char quote[300+1];              /* FTPコマンド */
    char localname[260+1];          /* ローカルファイル名 */
    char remotename[260+1];         /* リモートファイル名 */
    char end_program[260+1];        /* 正常時起動プログラム名 */
    char abend_program[260+1];      /* 異常時起動プログラム名 */
    char comment[80+1];             /* コメント */
    int fsize;                      /* サイズ確認 */
    char reserve[1240];             /* 予約領域 */
} FTS_FTP_API_DATA_EX;

伝送情報構造体メンバの内容

cardname：カード名称を指定します。

host：FTPのホスト名を指定します。ftp>open aaaa

portnum：FTPのポート番号を指定します。ftp>open aaaa bbbb

username：ログイン名を指定します。ftp>user aaaa

password：パスワードを指定します。

type：伝送モードを指定します。

FTS_TYPE_A：データをASCIIコードと解釈し，送信します。ftp>ascii

FTS_TYPE_I：データをイメージと解釈し，送信します。ftp>binary

mode：圧縮伝送を指定します。

　FTS_MODE_S：圧縮伝送をしません。

　FTS_MODE_C：圧縮伝送をします。

cmd：伝送の種類を指定します。

単／複伝送をORで指定することで，単一ファイル伝送または複数ファイル伝送を組み合わせて指定できます。

ただし，この指定は受信の場合だけ有効です。

伝送の種類

　FTS_CMD_SEND：送信します。ftp>put aaaa bbbb

　FTS_CMD_RECV：受信します。ftp>get cccc ddddd

　FTS_CMD_APPE：送信（追加）します。ftp>append eeee fffff

単／複伝送

　FTS_MLT_AUTO：単一ファイル伝送と複数ファイル伝送を自動で切り替えます。デフォルトです。

　FTS_MLT_MULTIPLE：複数ファイル伝送をします。

　FTS_MLT_SINGLE：単一ファイル伝送をします。

　FTS_MLT_AUTOでは，次のように伝送が自動切り替えされます。

　送信の場合：ローカルファイル名に，*または?が使用されているか判定し，*または?が使用されていれば複数ファイル伝送に，使用されていなければ単一ファイル伝送に切り替わります。

　受信の場合：リモートファイル名に，*または?が使用されているか判定し，*または?が使用されていれば複数ファイル伝送に，使用されていなければ単一ファイル伝送に切り替わります。

（例）

　単一ファイルの受信

　cmd = FTS_CMD_RECV | FTS_MLT_SINGLE;

quote：実行したいFTPコマンドを指定します。

CWD，SITEなどのコマンドをセミコロン（';'）で区切った文字列（文字列の最後は'¥0'）

指定できるコマンドは，データコネクションを確立しないコマンドに限られます。また，FTPサーバ側でコマンドが実行可能かどうかは，FTPサーバに依存します。

localname：ローカルファイル名を指定します。

（例）

　ftp>put aaaa bbbb

　ftp>get cccc dddd

remotename：リモートファイル名を指定します。

（例）

　ftp>put aaaa bbbb

　ftp>get cccc dddd

end_program：伝送正常終了時に起動するプログラム名をフルパスで指定します。

abend_program：伝送異常終了時に起動するプログラム名をフルパスで指定します。

comment：任意の文字列を指定できます。

fsize：伝送後のファイルサイズ確認の有無を指定します。

FTS_FSIZE_TRUE：サイズ確認をします。

FTS_FSIZE_FALSE：サイズ確認をしません。

reserve：予約領域です。「¥0」で初期化してください。

注意事項

char型の変数値の最後は，「¥0」にしてください。

伝送終了情報の取得

fts_ftp_syn_request_ex(),fts_ftp_asyn_request_ex()で登録した伝送要求に対する終了情報を取得できます。

fts_ftp_syn_request_ex()で要求を登録した場合

fts_ftp_syn_request_ex()の第4引数に伝送終了情報構造体のアドレスを指定します。

fts_ftp_asyn_request_ex()で要求を登録した場合

fts_ftp_event_ex()の第2引数に伝送終了情報構造体のアドレスを指定します。

伝送終了情報構造体

typedef struct _FTS_FTP_API_RETDATA_EX {
  /* 常時のデータ */
  int trans_status;          /* 伝送終了状態 成功（TRANS_SUCCESS） */
                             /* 伝送終了情報 失敗（TRANS_FAILURE） */
  char cardname[20+1];       /* カード名称 */
  unsigned long trno;        /* 伝送番号 */
  unsigned long trcno;       /* 接続番号 */

  /* 伝送成功時のデータ */
#ifdef FTS_API_64BIT
  unsigned __int64 trans_size; /* 伝送データサイズ */
  unsigned __int64 trans_size_comp; /* 圧縮後伝送データサイズ */
#else
  unsigned long trans_size;  /* 伝送データサイズ */
  unsigned long trans_size_comp; /* 圧縮後伝送データサイズ */
#endif

  /* 伝送失敗時のデータ */
  int ab_kind;               /* システムコールエラー(FTS_ERR_SYSTEM) */
                             /* 論理エラー(FTS_ERR_LOGIC) */
                             /* プロトコルエラー(FTS_ERR_PROTOCOL) */
  char ab_place[8];          /* エラー発生場所 */
  char ab_func[32];          /* エラー発生モジュール名称 */
  char ab_system[32];        /* システムコール名称 */
  int ab_syskind;            /* システムコール種別 */
                             /* Win32 API(FTS_SYSKIND_WIN32) */
                             /* C runtime(FTS_SYSKIND_CRUNTIME) */
                             /* WinSock API(FTS_SYSKIND_WINSOCK) */
  unsigned long ab_errno;    /* エラー番号 */
  char ab_promes[256];       /* プロトコルメッセージ（エラー） */

#ifndef FTS_API_64BIT
  /* 4ギガバイトを超えた伝送成功時のデータ */
  DWORD trans_size_Low;      /* 伝送データサイズ（下位32ビットの値）*/
  LONG trans_size_High;      /* 伝送データサイズ（上位32ビットの値）*/
  DWORD trans_size_comp_Low;
                          /* 圧縮後伝送データサイズ（上位32ビットの値）*/
  LONG trans_size_comp_High;
                          /* 圧縮後伝送データサイズ（下位32ビットの値）*/
#endif

  char reserve[1668];     /* 予約領域 */
} FTS_FTP_API_RETDATA_EX;

伝送終了情報構造体メンバの内容

trans_status：伝送の終了状態を示す次の値を返します。

TRANS_SUCCESS（正常終了）

TRANS_FAILURE（異常終了）

cardname：伝送のカード名称を返します。

trno：伝送番号を返します。

trcno：接続番号を返します。

trans_size：（正常終了時だけ）

伝送データサイズ

trans_size_comp：（正常終了時だけ）

伝送データサイズ（圧縮）

ab_kind：（異常終了時だけ）

エラー種別を返します。

FTS_ERR_SYSTEM（システムコールエラー）

FTS_ERR_LOGIC（論理エラー）

FTS_ERR_PROTOCOL（プロトコルエラー）

ab_place：（異常終了時だけ）

エラー発生場所を返します。

ab_func：（異常終了時だけ）

エラー発生モジュール名称を返します。

ab_system：（異常終了時だけ）

システムコール名称を返します。

ab_syskind：（異常終了時だけ）

システムコール種別を返します。

FTS_SYSKIND_WIN32（Win32 API）

FTS_SYSKIND_CRUNTIME（C runtime）

FTS_SYSKIND_WINSOCK（WinSock API）

ab_errno：（異常終了時だけ）

システムコールエラー番号を返します。

ab_promes：（異常終了時だけ）

FTPサーバより送られてきたプロトコルメッセージを返します。

trans_size_Low：（正常終了時だけ）

伝送データサイズの下位32ビットの値を返します。

trans_size_High：（正常終了時だけ）

伝送データサイズの上位32ビットの値を返します。

trans_size_comp_Low：（正常終了時だけ）

圧縮後の伝送データサイズの下位32ビットの値を返します。

trans_size_comp_High：（正常終了時だけ）

圧縮後の伝送データサイズの上位32ビットの値を返します。

reserve：予約領域です。

コーディング時の注意事項

JP1/FTP APIライブラリの関数を使用する前後に，必ず次の関数をコールしてください。

コール前

WSAStartUp()      winsock2ライブラリ

コール後

WSACleanUp()      winsock2ライブラリ

この関数をコールしない場合，ライブラリの関数は正しく動作しません。使用方法については，MSDNのマニュアルを参照してください。

trans_size_Lowとtrans_size_Highは，2つのパラメータを組み合わせて1つの64ビット値を形成します。

trans_size_comp_Lowとtrans_size_comp_Highは，2つのパラメータを組み合わせて1つの64ビット値を形成します。

コンパイルとリンク

64ビット用を使用する場合，プリプロセッサへの定義で，FTS_API_64BITを定義してください。

ライブラリ使用時の注意事項

次のような使用方法はできません。

1プロセスで，マルチスレッドによって複数のfts_ftp_open_ex()を同時に発行

1つのfts_ftp_open_ex()で複数のfts_ftp_syn_request_ex(),fts_ftp_asyn_request_ex()を同時に発行（マルチスレッドによるfts_ftp_syn_request_ex(),fts_ftp_asyn_request_ex()の同時実行）

ワイルドカード指定した場合，取得できる伝送終了情報は，次のとおりです。

正常の場合：最後に伝送したファイルの伝送終了情報

異常の場合：最初に異常になったファイルの伝送終了情報

ライブラリの使用例題

使用例題として，登録済みの伝送カード（伝送カード名：CARD1〜3）を使用して，非同期の伝送要求の登録と，終了結果の取得をするサンプルプログラムを次に示します。

図7‒1　サンプルプログラムフローチャート

/*********************************************************************/
/* Sample program: program to register an asynchronous transmission  */
/* request and obtain the transmission termination results           */
/*   (This example uses a registered card)                           */
/*********************************************************************/
#include <apihead.h>
#include <windows.h>
#include <stdio.h>

#define CARD1   "card1"
#define CARD2   "card2"
#define CARD3   "card3"

#define FTS_EXECUTION   0
#define FTS_SUCCESS     1

#define FTS_MAX_RETRY   3

int main()
{
    FTS_FTP_API_DATA_EX data1, data2, data3;
        /* Transmission information structure */
    FTS_FTP_API_RETDATA_EX  ret_data;
        /* End of transmission information structure */
    FTS_FTP_API_CONN_DATA con_data;
        /* Connect information structure */

    SOCKET sock;
    WSADATA WSAData;
    DWORD trno1, trno2, trno3;
    DWORD status;
    int flag1, flag2, flag3;
    int err_num;
    int i;

    /****************************************************/
    /* Initialize the socket routine (This is required.)*/
    /****************************************************/
    status = WSAStartup( MAKEWORD(2,2), &WSAData );
    if( status ) {
        /* Error */
        printf( "WSAStartup() error number = %d¥n", status );
        return 1;
    }

    flag1 = FTS_EXECUTION;
    flag2 = FTS_EXECUTION;
    flag3 = FTS_EXECUTION;

    for( i = 0; i <= FTS_MAX_RETRY; i++ ) {
        if( i == 0 ) {
            printf( "Transmission is executed. ¥n" );
        } else {
            printf( "Transmission is executed again.¥n" );
        }

        memset( &data1, 0, sizeof(FTS_FTP_API_DATA_EX) );
        memset( &data2, 0, sizeof(FTS_FTP_API_DATA_EX) );
        memset( &data3, 0, sizeof(FTS_FTP_API_DATA_EX) );

        /**************************************************/
        /* Establish a connection with JP1/FTP            */
        /**************************************************/
        memset( &con_data, 0, sizeof(FTS_FTP_API_CONN_DATA) );
        con_data.priority = FTS_AF_INET;

        sock = fts_ftp_open_ex( &con_data );
        if( sock == INVALID_SOCKET ) {
        /* Error */
            err_num = WSAGetLastError();
            printf( "fts_ftp_open_ex() error!! error number = %d¥n", err_num );
            WSACleanup();
            return 1;
        }

        /*************************************/
        /* Register the transmission request */
        /*************************************/
        if( flag1 == FTS_EXECUTION ) {
            if( !fts_ftp_asyn_request_ex( sock, CARD1, &data1, &trno1, FTS_GET_RETURN ) ) {
                /* Error */
                err_num = WSAGetLastError();
                printf( "fts_ftp_request_ex(1) error!! error number = %d¥n", err_num );
            }
        }
        if( flag2 == FTS_EXECUTION ) {
            if( !fts_ftp_asyn_request_ex( sock, CARD2, &data2, &trno2, FTS_GET_RETURN ) ) {
                /* Error */
                err_num = WSAGetLastError();
                printf( "fts_ftp_request_ex(2) error!! error number = %d¥n", err_num );
            }
        }
        if( flag3 == FTS_EXECUTION ) {
            if( !fts_ftp_asyn_request_ex( sock, CARD3, &data3, &trno3, FTS_GET_RETURN ) ) {
                /* Error */
                err_num = WSAGetLastError();
                printf( "fts_ftp_request_ex(3) error!! error number = %d¥n", err_num );
            }
        }

        /***********************************************/
        /* Obtain the transmission termination results */
        /***********************************************/
        while(1) {
            if( !fts_ftp_event_ex( sock, &ret_data ) ) {
                err_num = WSAGetLastError();
                if( err_num == FTS_API_ERROR_NODATA ) {
                    /* Obtained all the transmission termination results */
                    break;
                } else {
                    /* Error */
                    printf( "fts_ftp_event_ex error!! error number = %d¥n", err_num );
                    fts_ftp_close( sock );
                    WSACleanup();
                    return 1;
                }
            }
            if( flag1 == FTS_EXECUTION ) {
                if( ret_data.trno == trno1 ) {
                    /* Termination of CARD1 */
                    if( ret_data.trans_status == TRANS_SUCCESS ) {
                        /* Transmission ends normally. */
                        printf( "CARD1 trnas success!!¥n" );
                        flag1 = FTS_SUCCESS;
                    } else {
                        /* Transmission ends abnormally. */
                        printf( "CARD1 trnas failure!!¥n" );
                    }
                    continue;
                }
            }
            if( flag2 == FTS_EXECUTION ) {
                if( ret_data.trno == trno2 ) {
                    /* Termination of CARD2 */
                    if( ret_data.trans_status == TRANS_SUCCESS ) {
                        /* Transmission ends normally. */
                        printf( "CARD2 trnas success!!¥n" );
                        flag2 = FTS_SUCCESS;
                    } else {
                        /* Transmission ends abnormally. */
                        printf( "CARD2 trnas failure!!¥n" );
                    }
                    continue;
                }
            }
            if( flag3 == FTS_EXECUTION ) {
                if( ret_data.trno == trno3 ) {
                    /* Termination of CARD3 */
                    if( ret_data.trans_status == TRANS_SUCCESS ) {
                        /* Transmission ends normally. */
                        printf( "CARD3 trnas success!!¥n" );
                        flag3 = FTS_SUCCESS;
                    } else {
                        /* Transmission ends abnormally. */
                        printf( "CARD3 trnas failure!!¥n" );
                    }
                    continue;
                }
            }
        }

        /***************************************************/
        /* Release the connection with JP1/FTP             */
        /***************************************************/
        fts_ftp_close( sock );

        if( flag1 == FTS_SUCCESS && flag2 == FTS_SUCCESS && flag3 == FTS_SUCCESS ) {
            break;
        }
    }
    /***************************************************/
    /* Release the socket routine. (Required)          */
    /***************************************************/
    WSACleanup();

    printf( "Transmission is ended. ¥n" );

    return 0;
}

関数一覧

JP1/FTP APIライブラリで使用できる関数の一覧を次に示します。

表7‒2　JP1/FTP APIライブラリで使用できる関数

機能

関数名

JP1/FTPとのコネクションの確立

fts_ftp_open_ex()

伝送要求の登録（同期）

fts_ftp_syn_request_ex()

伝送要求の登録（非同期）

fts_ftp_asyn_request_ex()

伝送終了結果の取得

fts_ftp_event_ex()

伝送の取り消し

fts_ftp_cancel()

JP1/FTPとのコネクションの解放

fts_ftp_close()

注意事項

上記以外に，次に示す関数をJP1/FTPの旧バージョンとの互換性のために提供しています。

fts_ftp_open()

関数の詳細

関数は，ユーザプログラムから次の順序でコールします。

fts_ftp_open_ex()をコールし，JP1/FTPとのコネクションを確立します。

伝送情報を伝送情報構造体にセットし，fts_ftp_syn_request_ex()（同期）fts_ftp_asyn_request_ex()（非同期）をコールして伝送の登録をします。fts_ftp_syn_request_ex()の場合は，関数の終了と同時に伝送の終了結果を取得できます。

2.でfts_ftp_asyn_request_ex()をコールした場合は，fts_ftp_event_ex()をコールすることで，伝送の終了結果を取得できます。

fts_ftp_cancel()をコールすることで，実行中の伝送（サーバ，クライアント）を取り消せます。ただし，JP1/FTPとのコネクションは必要ありません。

fts_ftp_close()をコールすることで，JP1/FTPとのコネクションを解放します。

以降の関数の説明では，コールする順番に説明します。

fts_ftp_open_ex()−JP1/FTPとのコネクション確立−

形式

#include <winsock2.h>
#include <apihead.h>

SOCKET  fts_ftp_open_ex( FTS_FTP_API_CONN_DATA *condata )

機能

JP1/FTP Clientサービスとのコネクションを確立します。

引数

condata

接続情報構造体のアドレスを指定します。接続情報に従ってJP1/FTP Clientサービスに接続します。

注意事項

この関数は，fts_ftp_syn_request_ex()，fts_ftp_asyn_request_ex()，fts_ftp_close()をコールする前にコールしてください。

この関数の戻り値は，ほかの関数を使用するときに必要です。

拡張エラー情報を取得する場合は，WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。

戻り値

ソケットハンドラ

正常

INVALID_SOCKET

異常

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_NOTSTARTUP

（0x2FFFFF00，805306112）

WSAStartup()がコールされていません。

否

FTS_API_ERROR_UNDEFFTSHOST

（0x2FFFFF01，805306113）

指定したホスト名はHOSTSファイルで定義されていません。

否

FTS_API_ERROR_CONNREFUSED

（0x2FFFFF02，805306114）

接続要求が拒否されました。JP1/File Transmission Server/FTP Clientサービスが開始されていない場合があります。

否

FTS_API_ERROR_TIMEOUT

（0x2FFFFF03，805306115）

JP1/File Transmission Server/FTP Clientサービスへの接続要求がタイムアウトしました。JP1/File Transmission Server/FTP Clientサービスで接続処理に時間が掛かっているか，JP1/File Transmission Server/FTP Clientサービスが動作するマシンが停止している場合があります。

可

FTS_API_ERROR_UNREACH

（0x2FFFFF04，805306116）

JP1/File Transmission Server/FTP Clientサービスが動作するホストへルーティングされていない場合があります。

否

FTS_API_ERROR_DISCONNECT

（0x2FFFFF05，805306117）

JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は，fts_ftp_open_ex()から処理をし直す必要があります。

否

FTS_API_ERROR_MEMORY

（0x2FFFFF0B，805306123）

メモリを確保できません。

否

FTS_API_ERROR_UNDEFFTSSERV

（0x2FFFFF0C，805306124）

SERVISESファイルでJP1/File Transmission Server/FTP Client (ftsc)の定義がされていません。

否

FTS_API_ERROR_MAXCONNECT

（0x2FFFFF0F，805306127）

同時に接続（fts_ftp_open_ex()を発行）できるAPIの数（64）を超えました。ほかのAPIが接続を切断（fts_ftp_close()を発行）するまで接続できません。

可

fts_ftp_syn_request_ex()−伝送要求の登録（同期）−

形式

#include <winsock2.h>
#include <apihead.h>

BOOL  fts_ftp_syn_request_ex( SOCKET sock,
                    const char *cardname,
                    FTS_FTP_API_DATA_EX *data,
                    FTS_FTP_API_RETDATA_EX *retdata )

機能

JP1/FTPに伝送要求を登録し，伝送の終了を待って終了結果を返します。伝送要求の内容は，伝送情報構造体で指定するか，登録済みの伝送カード名を指定することで定義できます。終了結果は，伝送終了情報構造体に返されます。伝送の正常/異常は，伝送終了情報構造体のtrans_statusメンバで判断できます。

引数

sock

fts_ftp_open_ex()の戻り値を指定します。

cardname

登録済みの伝送カード名を指定します。伝送カードの内容に従ってファイル伝送要求を登録します。

data

伝送情報構造体のアドレスを指定します。

cardnameにNULLが指定された場合は，dataに指定された内容に従ってファイル伝送要求を登録します。

cardnameに登録済みの伝送カード名が指定された場合は，伝送カードの内容に従ってファイル伝送要求を登録します。

retdata

伝送終了情報構造体のアドレスを指定します。伝送の終了結果を返します。

注意事項

この関数は，fts_ftp_open_ex()をコールしたあとでコールしてください。

この関数は，要求した伝送が終了するまで戻りません。

拡張エラー情報を取得する場合は，WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。

戻り値

TRUE

正常

FALSE

異常

伝送要求の登録または伝送終了結果の取得に失敗しました。

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_NOTSTARTUP

（0x2FFFFF00，805306112）

WSAStartup()がコールされていません。

否

FTS_API_ERROR_DISCONNECT

（0x2FFFFF05，805306117）

JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は，fts_ftp_close()を発行し，fts_ftp_open_ex()から処理をし直す必要があります。

否

FTS_API_ERROR_NOTREADCARD

（0x2FFFFF06，805306118）

指定したカード名称が参照できません。カードが正しく登録されていない場合があります。

否

FTS_API_ERROR_BADFORMAT

（0x2FFFFF07，805306119）

引数に誤ったデータタイプのアドレスが指定されています。

否

FTS_API_ERROR_MAXPALTRANS

（0x2FFFFF08，805306120）

同時最大伝送数を超えています。ほかの伝送が終了したあと，再度伝送要求を登録してください。

可

FTS_API_ERROR_MEMORY

（0x2FFFFF0B，805306123）

メモリを確保できません。

否

FTS_API_ERROR_NOTSOCK

（0x2FFFFF0D，805306125）

fts_ftp_open_ex()の戻り値を第1引数に指定していない場合があります。

否

FTS_API_ERROR_LOGIC

（0x2FFFFF10，805306128）

API内で論理矛盾エラーが発生しました。

否

fts_ftp_asyn_request_ex()−伝送要求の登録（非同期）−

形式

#include <winsock2.h>
#include <apihead.h>

BOOL  fts_ftp_asyn_request_ex( SOCKET sock,
                     const char *cardname,
                     FTS_FTP_API_DATA_EX *data,
                     unsigned long *trno,
                     int get_return_flag )

機能

JP1/FTPに伝送要求を登録し，伝送の終了を待ちません。終了結果は，fts_ftp_event_ex()で取得します。伝送要求の内容は，伝送情報構造体で指定するか，登録済みの伝送カード名を指定することで定義できます。伝送の正常・異常は，fts_ftp_event_ex()で取得した伝送終了情報構造体のtrans_statusメンバで判断できます。

引数

sock

fts_ftp_open_ex()の戻り値を指定します。

cardname

登録済カード名称を指定します。この内容に従ってファイル伝送要求を登録します。

data

伝送情報構造体のアドレスを指定します。

cardnameにNULLが指定された場合は，この内容に従ってファイル伝送要求を登録します。

cardnameに登録済みの伝送カード名が指定された場合は，伝送カードの内容を登録します。

trno

伝送番号を格納するアドレスを指定します。

履歴情報やfts_ftp_event_ex()で取得した伝送終了情報内の伝送番号と一致します。

get_return_flag

FTS_GET_RETURNを指定した場合は，fts_ftp_event_ex()をコールすることで伝送終了情報を取得できます。

FTS_UNGET_RETURNを指定した場合は，取得できません。

注意事項

この関数は，fts_ftp_open_ex()をコールしたあとでコールしてください。

伝送終了情報を取得する場合は，第5引数にFTS_GET_RETURNを指定し，fts_ftp_event_ex()でコールしてください。この場合，fts_ftp_event_ex()は必ず発行してください。発行しない間は，伝送終了情報が関数を発行したプロセスまたはJP1/FTP内に残るため，システム資源（メモリ）を消費して解放できない場合があります。

終了情報を取得しない場合は，第5引数にFTS_UNGET_RETURNを指定してください。

戻り値

TRUE

正常

FALSE

異常

伝送要求の登録に失敗しました。

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_NOTSTARTUP

（0x2FFFFF00，805306112）

WSAStartup()がコールされていません。

否

FTS_API_ERROR_DISCONNECT

（0x2FFFFF05，805306117）

JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は，fts_ftp_close()を発行し，fts_ftp_open_ex()から処理をし直す必要があります。

否

FTS_API_ERROR_NOTREADCARD

（0x2FFFFF06，805306118）

指定したカード名称が参照できません。

カードが正しく登録されていない場合があります。

否

FTS_API_ERROR_BADFORMAT

（0x2FFFFF07，805306119）

引数に誤ったデータタイプのアドレスが指定されています。

否

FTS_API_ERROR_MAXPALTRANS

（0x2FFFFF08，805306120）

同時最大伝送数を超えています。

ほかの伝送が終了したあと，再度伝送要求を登録してください。

可

FTS_API_ERROR_MEMORY

（0x2FFFFF0B，805306123）

メモリを確保できません。

否

FTS_API_ERROR_NOTSOCK

（0x2FFFFF0D，805306125）

fts_ftp_open_ex()の戻り値を第1引数に指定していない場合があります。

否

FTS_API_ERROR_FTSMISS

（0x2FFFFF0E，805306126）

JP1/File Transmission Server/FTP Clientサービスで何かの異常が発生しました。

否

FTS_API_ERROR_LOGIC

（0x2FFFFF10，805306128）

API内で論理矛盾エラーが発生しました。

否

fts_ftp_event_ex()−伝送終了結果の取得−

形式

#include <winsock2.h>
#include <apihead.h>

BOOL  fts_ftp_event_ex( SOCKET sock, FTS_FTP_API_RETDATA_EX *retdata )

機能

fts_ftp_asyn_request_ex()で登録した伝送の終了結果を取得します。

伝送の正常・異常は，伝送終了情報構造体のtrans_statusメンバで判断できます。

引数

sock

fts_ftp_open_ex()の戻り値を指定します。

retdata

伝送終了情報構造体のアドレスを指定します。伝送の終了結果を返します。

注意事項

この関数は，fts_ftp_open_ex()をコールしたあとでコールしてください。

関数発行時に伝送が終了していない場合は，伝送が終了するまで待ちます。

拡張エラー情報を取得する場合は，WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。

戻り値

TRUE

正常

FALSE

異常

伝送終了情報の取得に失敗しました。

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_NOTSTARTUP

（0x2FFFFF00，8053306112）

WSAStartup()がコールされていません。

否

FTS_API_ERROR_DISCONNECT

（0x2FFFFF05，8053306117）

JP1/File Transmission Server/FTP Clientサービスとのコネクションが切断されました。伝送要求を再度登録したい場合は，fts_ftp_close()を発行し，fts_ftp_open_ex()から処理をし直す必要があります。

否

FTS_API_ERROR_BADFORMAT

（0x2FFFFF07，8053306119）

引数に誤ったデータタイプのアドレスが指定されています。

否

FTS_API_ERROR_NODATA

（0x2FFFFF09，8053306121）

登録されている伝送要求はありません。

否

FTS_API_ERROR_NOTSOCK

（0x2FFFFF0D，8053306125）

fts_ftp_open_ex()の戻り値を第1引数に指定していない場合があります。

否

FTS_API_ERROR_LOGIC

（0x2FFFFF10，8053306128）

API内で論理矛盾エラーが発生しました。

否

fts_ftp_cancel()−伝送の取り消し−

形式

#include <winsock2.h>
#include <apihead.h>

BOOL  fts_ftp_cancel( int cs_flag, unsigned long trno )

機能

実行中の伝送（サーバ，クライアント）を取り消します。

取り消された伝送は，異常終了します。

引数

cs_flag

取り消したい伝送のサービス種別を指定します。

FTS_CAN_SERVERを指定した場合は，サーバの伝送を取り消します。

FTS_CAN_CLIENTを指定した場合は，クライアントの伝送を取り消します。

2つの論理和を指定した場合は，サーバとクライアントの伝送を取り消します。

trno

取り消したい伝送の伝送番号を指定します。

FTS_CAN_ALLを指定した場合は，指定されたサービスのすべての伝送を取り消します。

注意事項

この関数は，JP1/FTPとのコネクションの確立は不要です。

戻り値

TRUE

正常

FALSE

異常

伝送の取消に失敗しました。

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_LOGIC

（0x2FFFFF10，805306128）

API内で論理矛盾エラーが発生しました。

否

FTS_API_ERROR_T_NOT_FOUND

（0x2FFFFF11，805306129）

指定された伝送は実行中ではありません。

否

FTS_API_ERROR_ARGUMENT

（0x2FFFFF12，805306130）

引数に誤った値を指定しています。

否

fts_ftp_close()−JP1/FTPとのコネクション解放−

形式

#include <winsock2.h>
#include <apihead.h>

BOOL  fts_ftp_close( SOCKET sock )

機能

JP1/FTPとのコネクションを解放します。

引数

sock

fts_ftp_open_ex()の戻り値

注意事項

fts_ftp_open_ex()が正常終了した場合は，すべての伝送登録処理が終了したあとでこの関数を必ずコールしてください。

拡張エラー情報を取得する場合は，WSAGetLastError関数をコールする前にほかの関数をコールしないでください。情報がなくなる場合があります。

戻り値

TRUE

正常

FALSE

異常

拡張エラー情報を取得するには，WSAGetLastError関数を呼び出します。拡張エラー情報の戻り値を次の表に示します。また，下記以外のエラーについては，MSDNのマニュアルを参照してください。

拡張エラー情報の戻り値

（16進数，10進数）

説明

リトライの可否

FTS_API_ERROR_INVALIDSOCK

（0x2FFFFF0A，805306122）

無効な引数を指定しました。fts_ftp_open_ex()の戻り値でない場合があります。

否

FTS_API_ERROR_LOGIC

（0x2FFFFF10，805306128）

API内で論理矛盾エラーが発生しました。

否

8　メッセージ

この章では，JP1/FTPが出力するメッセージについて説明します。

8.1　メッセージの形式

JP1/FTPが出力するメッセージは，イベントビューアに表示されるものと，コマンド実行時に表示されるものがあります。メッセージの形式とマニュアルでの記載形式を，次に示します。

8.1.1　メッセージの出力形式

出力契機ごとに説明します。

(1)　イベントビューアに表示されるメッセージ

イベントビューアは，Windowsの［スタート］メニューから［プログラム］−［管理ツール（共通）］−［イベントビューア］で起動します。

種類

メッセージの種類を示します。

エラー：処理は中断されます。

警告：メッセージ出力後，処理は続けられます。

情報：システムの動作結果を示します。

分類

XXX YYYの形式で示されます。

XXX：

メッセージの出力契機対象を示します。次の5つがあります。

Agent

Backup

Client

Server

Log

YYY：

メッセージの種類を示します。

Error：エラー

Warning：警告

info：情報

(2)　コマンド実行時に表示されるメッセージ

メッセージテキストだけが表示されます。

(3)　アクセスログに表示されるメッセージ

アクセスログファイルに，日時とメッセージテキストが表示されます。

8.1.2　メッセージの記載形式

このマニュアルでのメッセージの記載形式を示します。この章では，メッセージ中の可変値を斜体 で示しています。

(1)　イベントビューアに表示されるメッセージ

メッセージは，メッセージID順に表形式で示します。記載形式の例を次に示します。

イベントID

種類

分類

説明

補足

イベント識別子

メッセージの種類

エラーの出力契機対象と種類

メッセージテキスト

補足事項

(2)　コマンド実行時に表示されるメッセージ

メッセージは，コマンドごとに50音順に並べ，表形式で示します。記載形式の例を次に示します。

表示されるメッセージ

要因

対処法

メッセージテキスト

メッセージが出力される要因

メッセージが出力されたときにとる対処

(3)　アクセスログに表示されるメッセージ

記載形式の例を次に示します。

表示されるメッセージ

要因

メッセージテキスト

メッセージが出力される要因

8.2　イベントビューアに表示されるメッセージ

イベントビューアに表示されるメッセージの一覧を次の表に示します。

表8‒1　イベントビューアに表示されるメッセージ

イベントID

種類

分類※19

説明

補足

2

エラー

警告

Log Error (107)

Log Warning (109)

Agent Error (113)

Agent Warning (115)

Server Warning (106)

Client Error (101)

Client Warning (103)

システムコールエラーが発生しました。

発生関数名：※1

発生場所：※2

関数名：※3

エラーメッセージ：※4

詳細：※5

システムコールエラー発生時のエラーおよび警告ログ

対処法：（表8-2参照）

3

エラー

Server Error (104)

システムコールエラーが発生しました。

接続番号：※6

発生関数名：※1

発生場所：※2

関数名：※3

エラーメッセージ：※4

ユーザ名：※7

IPアドレス：※8

詳細：※5

システムコールエラー発生時のエラーログ

4

エラー

警告

Server Error (104)

Server Warning (106)

システムコールエラーが発生しました。

接続番号：※6

伝送番号：※9

発生関数名：※1

発生場所：※2

関数名：※3

エラーメッセージ：※4

ユーザ名：※7

IPアドレス：※8

ローカルファイル名：※10

詳細：※5

ファイル伝送中のシステムコールエラー発生時のエラーおよび警告ログ

対処法：（表8-3参照）

5

エラー

Client Error (101)

Log Error (107)

Server Error (104)

Agent Error (113)

論理エラーが発生しました。

発生関数名：※1

発生場所：※2

論理エラー発生時のエラーログ

6

警告

Client Warning (103)

プロトコルエラーが発生しました。

発生関数名：※1

発生場所：※2

リプライメッセージ：※11

接続番号：※6

伝送番号：※9

ログインユーザ名：※12

ログインホスト名：※13

伝送種別：※14

ローカルファイル名：※15

リモートファイル名：※16

プロトコルエラー発生時のエラーログ

7

エラー

警告

Client Error (101)

Client Warning (103)

システムコールエラーが発生しました。

発生関数名：※1

発生場所：※2

関数名：※3

エラーメッセージ：※4

接続番号：※6

伝送番号：※9

ログインユーザ名：※12

ログインホスト名：※13

伝送種別：※14

ローカルファイル名：※15

リモートファイル名：※16

詳細：※5

システムコールエラー発生時のエラーログ

対処法：（表8-4参照）

8

エラー

Client Error (101)

論理エラーが発生しました。

発生関数名：※1

発生場所：※2

接続番号：※6

伝送番号：※9

ログインユーザ名：※12

ログインホスト名：※13

伝送種別：※14

ローカルファイル名：※15

リモートファイル名：※16

論理エラー発生時のエラーログ

9

エラー

Log Error (107)

ディスクがいっぱいの為，履歴が出力できません。不用なファイルを削除して下さい。

履歴書き込み時にディスク容量が不足していた時のエラーログ

10

警告

Client Warning (103)

Server Warning (106)

ディスクがいっぱいの為，トレースが出力できません。不用なファイルを削除して下さい。

トレース書き込み時にディスク容量が不足していた時の警告ログ

11

情報

Server Info (105)

JP1/File Transmission Server/FTP Serverサービスを開始しました。

サーバサービス開始時の情報ログ

12

情報

Server Info (105)

JP1/File Transmission Server/FTP Serverサービスを終了しました。

サーバサービス終了時の情報ログ

14

情報

Client Info (102)

JP1/File Transmission Server/FTP Clientサービスを開始しました。

クライアントサービス開始時の情報ログ

15

情報

Client Info (102)

JP1/File Transmission Server/FTP Clientサービスを終了しました。

クライアントサービス終了時の情報ログ

17

警告

Client Warning (103)

Server Warning (106)

ログサーバがコネクションを強制切断しました。

ログサービスが接続を強制切断した時の警告ログ

18

警告

Server Warning (106)

最大同時伝送数を超えたため要求を拒否しました。

要求元IPアドレス：※7

サーバ接続時に最大接続数を上回った時の警告ログ

19

情報

Log Info (108)

JP1/File Transmission Server/FTP Logサービスを開始しました。

ログサービス開始時の情報ログ

20

情報

Log Info (108)

JP1/File Transmission Server/FTP Logサービスを終了しました。

ログサービス終了時の情報ログ

21

エラー

Client Error (101)

Server Error (104)

Log Error (107)

Agent Error (113)

Servicesファイルにポート番号の定義がされていません。［指定されていないサービス名］

サービス開始時のエラーログ

24

情報

Server Info (105)

伝送が正常終了しました。

接続番号：※6

伝送番号：※9

ユーザ名：※7

IPアドレス：※8

ローカルファイル名：※10

伝送が正常終了した時の情報ログ

25

エラー

Server Error (104)

伝送が異常終了しました。

接続番号：※6

伝送番号：※9

ユーザ名：※7

IPアドレス：※8

ローカルファイル名：※10

伝送が異常終了した時のエラーログ

26

情報

Client Info (102)

伝送が正常終了しました。

接続番号：※6

伝送番号：※9

カード名：※17

ログインユーザ名：※12

ログインホスト名or IPアドレス：※13

ローカルファイル名：※15

リモートファイル名：※16

伝送が正常終了した時の情報ログ

27

エラー

Client Error (101)

伝送が異常終了しました。

接続番号：※6

伝送番号：※9

カード名：※17

ログインユーザ名：※12

ログインホスト名or IPアドレス：※13

ローカルファイル名：※15

リモートファイル名：※16

伝送が異常終了した時の情報ログ

28

情報

Agent Info (114)

JP1/File Transmission Server/FTP Agentサービスを開始しました。

運用管理エージェントサービス開始時の情報ログ

29

情報

Agent Info (114)

JP1/File Transmission Server/FTP Agentサービスを終了しました。

運用管理エージェントサービス終了時の情報ログ

30

情報

Log Info (108)

既存履歴情報ファイル(history)をコピーします。(FTSLOGSAVE)(※18)(履歴情報ポインタ )

履歴情報ファイルをコピーした時の情報ログ

31

情報

Log Info (108)

履歴情報ファイル(history)を新しく作成します。(履歴情報ポインタ )

履歴情報ファイルを新しく作成した時の情報ログ

33

情報

Server Info (105)

伝送が開始しました。

接続番号：接続番号

伝送番号：伝送番号

ユーザ名：ユーザ名

IPアドレス：IPアドレス

ローカルファイル名：ローカルファイル名

伝送が開始した時の情報ログ

34

情報

Client Info (102)

伝送が開始しました。

接続番号：接続番号

伝送番号：伝送番号

カード名：カード名

ログインユーザ名： ログインユーザ名

ログインホスト名or IPアドレス：ログインホスト名or IPアドレス

ローカルファイル名：ローカルファイル名

リモートファイル名：リモートファイル名

伝送が開始した時の情報ログ

37

警告

Server Warning (106)

Client Warning (103)

接続番号または伝送番号の保存中にエラーが発生しました。

発生関数名：※1

発生場所：※2

関数名：※3

エラーメッセージ：※4

詳細：※5

接続番号または伝送番号の書き込み失敗時の警告ログ

38

エラー

Client Error (101)

論理エラーが発生しました。

発生関数名：※1

発生場所：※2

詳細：※5

論理エラー発生時のエラーログ

39

情報

Log Info (108)

LogサービスとClientサービスが接続されました。

ログサービスがクライアントサービスに接続した時の情報ログ

40

情報

Log Info (108)

LogサービスとServerサービスが接続されました。

ログサービスがサーバサービスに接続した時の情報ログ

41

情報

Log Info (108)

LogサービスとClientサービスが切断されました。

ログサービスがクライアントサービスとの接続を切断した時の情報ログ

42

情報

Log Info (108)

LogサービスとServerサービスが切断されました。

ログサービスがサーバサービスとの接続を切断した時の情報ログ

1001

情報

警告

Backup Info (110)

Backup Warning (111)

ＪＰ１／ＦＴＰの定義情報を保存しました。

(保存する情報がない場合は，情報がない旨のメッセージ )

ftssaveコマンド使用時の情報および警告ログ

1002

情報

警告

Backup Info (110)

Backup Warning (111)

ＪＰ１／ＦＴＰの定義情報を復元しました。

(自動起動プログラムの登録情報を復元する場合，該当するユーザがなかった場合，その旨のメッセージ )

ftsloadコマンド使用時のエラーログ

1003

エラー

Backup Error (112)

ＪＰ１／ＦＴＰの定義情報を保存中にエラーが発生しました。

※4

ftssaveコマンド使用時のエラーログ

1004

エラー

Backup Error (112)

ＪＰ１／ＦＴＰの定義情報を復元中にエラーが発生しました。

※4

ftsloadコマンド使用時のエラーログ

1006

エラー

Backup Error (112)

ｆｔｓｓａｖｅ コマンドの指定に誤りがあります

※4

ftssaveコマンド使用時のエラーログ

1007

エラー

Backup Error (112)

ｆｔｓｌｏａｄ コマンドの指定に誤りがあります

※4

ftsloadコマンド使用時のエラーログ

注※1

エラーが発生した処理の含まれた関数名

注※2

関数内でエラーを検知した場所番号

注※3

エラーが発生した関数名

注※4

エラーの内容を示すメッセージ

注※5　（サーバサービスとクライアントサービスの場合）

詳細エラー内容

注※6

JP1/FTPが管理している接続番号

注※7　（サーバ使用時）

接続ユーザ名

注※8　（サーバ使用時）

接続ユーザのマシンのIPアドレス

注※9

JP1/FTPが管理している伝送番号

注※10　（サーバ使用時）

伝送ファイルのサーバ側の名前

注※11

接続先サーバの応答メッセージ

注※12　（クライアント使用時）

接続に使用したユーザ名

注※13　（クライアント使用時）

接続先のホスト名，またはIPアドレス

注※14

send（送信上書き），append（送信追加書き），recv（受信）で表す送受信種別

注※15　（クライアント使用時）

伝送ファイルのクライアント側の名前

注※16　（クライアント使用時）

伝送ファイルのサーバ側の名前

注※17　（クライアント使用時）

伝送カード名

注※18　1〜3のどれか

1：履歴サイズが既存の履歴情報ファイルより小さくなった場合

2：以前の履歴情報ポインタより既存の履歴情報ファイルが小さくなった場合

3：既存の履歴情報ファイルが旧バージョンの場合

注※19

括弧内の数字で表示されます。

表8‒2　イベントID=2の対処法

関数名

エラーメッセージ

対処法

IMEventLoad

ライブラリがみつかりません。(50)

JP1/Baseをインストールしてください。

IMEventOpenSender

イベントサービスに接続不可能です。(40)

JP1/Baseを起動してください。

表8‒3　イベントID=4の対処法

発生関数名

関数名

エラーメッセージ

対処法

−

IMEventLoad

ライブラリがみつかりません。(50)

JP1/Baseをインストールしてください。

−

IMEventOpenSender

イベントサービスに接続不可能です。(40)

JP1/Baseを起動してください。

−

JpSeventOpen

イベントサーバに接続できません。(11)

イベントサーバとして使用するJP1/Baseの状態を確認してください。

fts_ss_callproc

SearchPath

指定されたファイルが見つかりません。(2)

自動起動プログラム情報の「正常時に起動するプログラム名（または異常時に起動するプログラム名）」を見直してください。

fts_ss_callproc

CreateProcess

アクセスが拒否されました。(5)

自動起動プログラム情報の「正常時に起動するプログラム名（または異常時に起動するプログラム名）」を見直してください。

retrieve

GetFileAttributes

指定されたファイルが見つかりません。(2)

サーバ側の伝送ファイル名を見直してください。

store

CreateFile

アクセスが拒否されました。(5)

サーバ側の伝送ファイル名を見直してください。

（凡例）

−：該当する関数はありません。

表8‒4　イベントID=7の対処法

発生関数名

関数名

エラーメッセージ

対処法

−

IMEventLoad

ライブラリがみつかりません。(50)

JP1/Baseをインストールしてください。

−

IMEventOpenSender

イベントサービスに接続不可能です。(40)

JP1/Baseを起動してください。

−

gethostbyname

ホストが見つかりません。(11001)

伝送情報のホスト名を見直してください。

fts_cs_callproc

SearchPath

指定されたファイルが見つかりません。(2)

伝送情報の「正常終了時起動プログラム名（または異常終了時起動プログラム名）」を見直してください。

fts_cs_callproc

CreateProcess

アクセスが拒否されました。(5)

伝送情報の「正常終了時起動プログラム名（または異常終了時起動プログラム名）」を見直してください。

sendrequest

GetFileAttributes

指定されたファイルが見つかりません。(2)

クライアント側の伝送ファイル名を見直してください。

fts_cs_recvrequest

CreateFile

アクセスが拒否されました。(5)

クライアント側の伝送ファイル名を見直してください。

（凡例）

−：該当する関数はありません。

8.3　コマンド実行時に表示されるメッセージ

表示されるメッセージの要因と対処法をコマンドごとに示します。

8.3.1　ftstranコマンド実行時のメッセージ

ftstranコマンドを実行したときに表示されるメッセージを次の表に示します。

表8‒5　ftstranコマンド実行時のメッセージ

表示されるメッセージ

要因

対処法

/TKスイッチの後にはCHECK|UNCHECKを指定して下さい。

/TKオプションのあとに，CHECK（サイズ確認あり），UNCHECK（サイズ確認なし）のどちらも指定されていません。

CHECK（サイズ確認あり）またはUNCHECK（サイズ確認なし）のどちらかを指定してください。

/TMスイッチの後にはSTREAM|COMPRESSを指定して下さい。

/TMオプションのあとに，STREAM（非圧縮），COMPRESS（圧縮）のどちらも指定されていません。

STREAM（非圧縮）またはCOMPRESS（圧縮）のどちらかを指定してください。

/TTスイッチの後にはSEND|RECV|APPEを指定して下さい。

/TTオプションのあとに，SEND（送信上書き），RECV（受信），APPE（送信追加書き）のどれも指定されていません。

SEND（送信上書き），RECV（受信），APPE（送信追加書き）のどれかを指定してください。

/TYスイッチの後にはASCII|BINARYを指定して下さい。

/TYオプションのあとに，ASCII（アスキー），BINARY（バイナリ）のどちらも指定されていません。

ASCII（アスキー）またはBINARY（バイナリ）のどちらかを指定してください。

/TAスイッチの後にはAUTO|MULTIPLE|SINGLEを指定して下さい。

/TAオプションのあとに，AUTO（自動切替），MULTIPLE（複数ファイル伝送），SINGLE（単一ファイル伝送）のどれも指定されていません。

AUTO（自動切替），MULTIPLE（複数ファイル伝送），SINGLE（単一ファイル伝送）のどれかを指定してください。

ＦＴＰコマンドの指定が長すぎます。

FTPコマンドの指定が制限値を超えています。

FTPコマンドは，300バイト以内で指定してください。

異常時に起動するプログラム名が長すぎます。

異常時に起動するプログラム名の指定が制限値を超えています。

異常時に起動するプログラム名は，259バイト以内で指定してください。

異常時に起動するプログラム名に＜，＞，”，｜，＊，？は指定できません。

異常時に起動するプログラム名の指定に，使用できない文字が使われています。

異常時に起動するプログラム名の指定を見直してください。

異常時に起動するプログラム名の指定に誤りがあります。

異常時に起動するプログラム名の指定に誤りがあります。

異常時に起動するプログラム名の指定を見直してください。

異常時に起動するプログラム名はフルパスで指定して下さい。

異常時に起動するプログラム名の指定が，フルパスで指定されていません。

異常時に起動するプログラム名は，フルパスで指定してください。

カード情報が取得できません。関数名（エラーコード）

カード情報取得時にシステムコールエラーが発生しました。

関数のエラーコードを見て対処してください。

カード名が長すぎます。

指定したカード名の指定が制限値を超えています。

カード名は，20バイト以内で指定してください。

コマンドラインの構文が誤っています。

コマンドラインの構文が誤っています。

コマンドラインの入力を見直してください。

コメントの指定が長すぎます。

コメントの指定が制限値を超えています。

コメントは，80バイト以内で指定してください。

スイッチが重複しています。- オプション

指定したオプションが重複しています。

オプションは重複しないように指定してください。

正常時に起動するプログラム名が長すぎます。

正常時に起動するプログラム名の指定が制限値を超えています。

正常時に起動するプログラム名は，259バイト以内で指定してください。

正常時に起動するプログラム名に＜，＞，”，｜，＊，？は指定できません。

正常時に起動するプログラム名の指定に，使用できない文字が使われています。

正常時に起動するプログラム名の指定を見直してください。

正常時に起動するプログラム名の指定に誤りがあります。

正常時に起動するプログラム名の指定に誤りがあります。

正常時に起動するプログラム名の指定を見直してください。

正常時に起動するプログラム名はフルパスで指定して下さい。

正常時に起動するプログラム名の指定が，フルパスで指定されていません。

正常時に起動するプログラム名は，フルパスで指定してください。

伝送が異常終了しました。

ファイルの送受信は異常終了しました。

伝送履歴を確認してください。

伝送が警告付きで正常終了しました。

（警告付き正常終了）

伝送履歴を確認してください。

伝送が正常終了しました。

（正常終了）

−

パスワードが長すぎます。

パスワードの指定が制限値を超えています。

パスワードは，50バイト以内で指定してください。

ファイル名が長すぎます。

指定したファイル名の指定が制限値を超えています。

ファイル名は259バイト以内で指定してください。

ファイル名の指定に誤りがあります。

指定したファイル名に誤りがあります。

ファイル名の指定を見直してください。

ポート番号は1から65535の範囲で指定して下さい。

ポート番号が1〜65535の整数ではありません。

1〜65535の範囲の整数を指定してください。

ポート番号は整数で指定して下さい。

ポート番号に整数以外の数値が含まれています。

整数を指定してください。

ホスト名が長すぎます。

指定したホスト名が制限値を超えています。

ホスト名は，256バイト以内で指定してください。

ホスト名の指定に誤りがあります。

指定したホスト名に誤りがあります。

ホスト名の指定を見直してください。

ユーザ名が長すぎます。

ユーザ名の指定が制限値を超えています。

ユーザ名は，50バイト以内で指定してください。

ユーザ名の指定に誤りがあります。

ユーザ名の指定に誤りがあります。

ユーザ名の指定を見直してください。

リモートファイル名が長すぎます。

リモートファイル名の指定が制限値を超えています。

リモートファイル名は，259バイト以内で指定してください。

リモートファイル名の指定に誤りがあります。

リモートファイル名の指定に誤りがあります。

リモートファイル名の指定を見直してください。

ローカルファイル名が長すぎます。

ローカルファイル名の指定が制限値を超えています。

ローカルファイル名は，259バイト以内で指定してください。

ローカルファイル名に＜，＞，”，｜は指定できません。

ローカルファイル名の指定に，使用できない文字が使われています。

ローカルファイル名の指定を見直してください。

ローカルファイル名の指定に誤りがあります。

ローカルファイル名の指定に誤りがあります。

ローカルファイル名の指定を見直してください。

（凡例）

−：対処法はありません。

8.3.2　ftsregcコマンド実行時のメッセージ

ftsregcコマンドを実行したときに表示されるメッセージを次の表に示します。

表8‒6　ftsregcコマンド実行時のメッセージ

表示されるメッセージ

要因

対処法

/TKスイッチの後にはCHECK|UNCHECKを指定して下さい。

/TKオプションのあとに，CHECK（サイズ確認あり），UNCHECK（サイズ確認なし）のどちらも指定されていません。

CHECK（サイズ確認あり）またはUNCHECK（サイズ確認なし）のどちらかを指定してください。

/TMスイッチの後にはSTREAM|COMPRESSを指定して下さい。

/TMオプションのあとに，STREAM（非圧縮），COMPRESS（圧縮）のどちらも指定されていません。

STREAM（非圧縮）またはCOMPRESS（圧縮）のどちらかを指定してください。

/TTスイッチの後にはSEND|RECV|APPEを指定して下さい。

/TTオプションのあとに，SEND（送信上書き），RECV（受信），APPE（送信追加書き）のどれも指定されていません。

SEND（送信上書き），RECV（受信），APPE（送信追加書き）のどれかを指定してください。

/TYスイッチの後にはASCII|BINARYを指定して下さい。

/TYオプションのあとに，ASCII（アスキー），BINARY（バイナリ）のどちらも指定されていません。

ASCII（アスキー）またはBINARY（バイナリ）のどちらかを指定してください。

/TAスイッチの後にはAUTO|MULTIPLE|SINGLEを指定して下さい。

/TAオプションのあとに，AUTO（自動切替），MULTIPLE（複数ファイル伝送），SINGLE（単一ファイル伝送）のどれも指定されていません。

AUTO（自動切替），MULTIPLE（複数ファイル伝送），SINGLE（単一ファイル伝送）のどれかを指定してください。

ＦＴＰコマンドの指定が長すぎます。

FTPコマンドの指定が制限値を超えています。

FTPコマンドは，300バイト以内で指定してください。

異常時に起動するプログラム名が長すぎます。

異常時に起動するプログラム名の指定が制限値を超えています。

異常時に起動するプログラム名は，259バイト以内で指定してください。

異常時に起動するプログラム名に＜，＞，”，｜，＊，？は指定できません。

異常時に起動するプログラム名の指定に，使用できない文字が使われています。

異常時に起動するプログラム名の指定を見直してください。

異常時に起動するプログラム名の指定に誤りがあります。

異常時に起動するプログラム名の指定に誤りがあります。

異常時に起動するプログラム名の指定を見直してください。

異常時に起動するプログラム名はフルパスで指定して下さい。

異常時に起動するプログラム名の指定が，フルパスで指定されていません。

異常時に起動するプログラム名は，フルパスで指定してください。

カード情報が取得できません。関数名（エラーコード）

カード情報取得時にシステムコールエラーが発生しました。

関数のエラーコードを見て対処してください。

カード名が長すぎます。

指定したカード名の指定が制限値を超えています。

カード名は，20バイト以内で指定してください。

カード名を指定して下さい。

カード名が指定されていません。

カード名を指定してください。

コマンドラインの構文が誤っています。

コマンドラインの構文が誤っています。

コマンドラインの入力を見直してください。

コメントの指定が長すぎます。

コメントの指定が制限値を超えています。

コメントは，80バイト以内で指定してください。

指定されたカード(カード名)は既に登録されています。

指定されたカード名と同じ名前のカードがあります。

カード名を変更してください。

指定されたカード(カード名)は登録されていません。

指定されたカードは登録されていません。

登録済みのカード名を指定してください。

スイッチが重複しています。- オプション

指定したオプションが重複しています。

オプションが重複しないように指定してください。

正常時に起動するプログラム名が長すぎます。

正常時に起動するプログラム名の指定が制限値を超えています。

正常時に起動するプログラム名は，259バイト以内で指定してください。

正常時に起動するプログラム名に＜，＞，”，｜，＊，？は指定できません。

正常時に起動するプログラム名の指定に，使用できない文字が使われています。

正常時に起動するプログラム名の指定を見直してください。

正常時に起動するプログラム名の指定に誤りがあります。

正常時に起動するプログラム名の指定に誤りがあります。

正常時に起動するプログラム名の指定を見直してください。

正常時に起動するプログラム名はフルパスで指定して下さい。

正常時に起動するプログラム名の指定が，フルパスで指定されていません。

正常時に起動するプログラム名は，フルパスで指定してください。

接続先ホスト名を指定して下さい。

接続先ホスト名の指定がありません。

接続先ホスト名の指定をしてください。

送受信種別(/TT SEND|RECV|APPE)を指定して下さい。

送受信種別の指定がありません。

/TTのあとに，送受信種別 SEND（送信上書き），RECV（受信），APPE（送信追加書き）のどれかを指定してください。

伝送モード（/TY ASCII｜BINARY）を指定し下さい。

伝送モードの指定がありません。

/TYのあとに，伝送モード種別ASCII（アスキー），BINARY（バイナリ）のどちらかを指定してください。

パスワードが長すぎます。

パスワードの指定が制限値を超えています。

パスワードは，50バイト以内で指定してください。

ポート番号は1から65535の範囲で指定して下さい。

ポート番号が1〜65535の整数ではありません。

1〜65535の範囲の整数を指定してください。

ポート番号は整数で指定して下さい。

ポート番号に整数以外の数値が含まれています。

整数を指定してください。

ホスト名が長すぎます。

指定したホスト名が制限値を超えています。

ホスト名は，256バイト以内で指定してください。

ホスト名の指定に誤りがあります。

指定したホスト名に誤りがあります。

ホスト名の指定を見直してください。

ユーザ名が長すぎます。

ユーザ名の指定が制限値を超えています。

ユーザ名は，50バイト以内で指定してください。

ユーザ名の指定に誤りがあります。

ユーザ名の指定に誤りがあります。

ユーザ名の指定を見直してください。

リモートファイル名が長すぎます。

リモートファイル名の指定が制限値を超えています。

リモートファイル名は，259バイト以内で指定してください。

リモートファイル名の指定に誤りがあります。

リモートファイル名の指定に誤りがあります。

リモートファイル名の指定を見直してください。

リモートファイル名を指定して下さい。

リモートファイル名の指定がありません。

リモートファイル名の指定をしてください。

ローカルファイル名が長すぎます。

ローカルファイル名の指定が制限値を超えています。

ローカルファイル名は，259バイト以内で指定してください。

ローカルファイル名に＜，＞，”，｜は指定できません。

ローカルファイル名の指定に，使用できない文字が使われています。

ローカルファイル名の指定を見直してください。

ローカルファイル名の指定に誤りがあります。

ローカルファイル名の指定に誤りがあります。

ローカルファイル名の指定を見直してください。

ローカルファイル名を指定して下さい。

ローカルファイル名の指定がありません。

ローカルファイル名の指定をしてください。

ログインユーザ名を指定して下さい。

ログインユーザ名の指定がありません。

ログインユーザ名を指定してください。

管理者で起動してください。

コマンドを起動したユーザが管理者ではありません。

コマンドを管理者で起動してください。

8.3.3　ftshistoryコマンド実行時のメッセージ

ftshistoryコマンドを実行したときに表示されるメッセージを次の表に示します。

表8‒7　ftshistoryコマンド実行時のメッセージ

表示されるメッセージ

要因

対処法

コマンドラインの構文が誤っています。

コマンドラインの構文が誤っています。

コマンドラインの入力を見直してください。

指定した履歴ファイルを参照できません。

または，一時ファイルにコピーできません。

コピー元ファイル

コピー先ファイル

CopyFile code =エラーコード

エラーメッセージ

一時ファイルへのコピーに失敗しました。

エラーメッセージを見て対処してください。

参照する履歴がありません。

参照する履歴がありません。

−

ファイルアクセスエラー

関数 code =エラーコード

エラーメッセージ

履歴ファイルにアクセス時にエラーが発生しました。

エラーメッセージを見て対処してください。

ファイルアクセスエラー

関数 code =エラーコード

POS=位置

エラーメッセージ

履歴ファイルにアクセス時にエラーが発生しました。

位置：履歴ファイル内のエラーがある履歴情報の位置（単位：件）

エラーメッセージを見て対処してください。

ファイルアクセスエラー

関数 code =エラーコード

POS=位置1,位置2

エラーメッセージ

履歴ファイルにアクセス時にエラーが発生しました。

位置1：処理の位置（単位：件）

位置2：履歴ファイル内のエラーがある履歴情報の位置（単位：件）

エラーメッセージを見て対処してください。

履歴ファイルの一部が破壊されています。

位置=位置

履歴ファイルの一部が破壊されています。

位置：履歴ファイル内のエラーがある履歴情報の位置（単位：件）

履歴ファイルを見直してください。

ＦＴＳの履歴ファイルではありません。

または，履歴ファイルが破壊されています。

JP1/FTPの履歴ファイルではありません。

または，履歴ファイルが破壊されています。

履歴ファイルを見直してください。

フォームファイルがありません。

フォーマットファイルがありません。

フォーマットファイルを見直してください。

フォームファイルを参照できません。

関数 code =エラーコード

エラーメッセージ

フォーマットファイルにアクセス時にエラーが発生しました。

エラーメッセージを見て対処してください。

フォームにキーがありません。

フォーマットファイルにキーがありません。

−

ファイルへ出力できません。

関数 code =エラーコード

エラーメッセージ

ファイルへの出力に失敗しました。

エラーメッセージを見て対処してください。

インストールディレクトリを取得できません。

関数 レジストリキー code =エラーコード

エラーメッセージ

C:¥Program Files¥Hitachi¥FTSFTPを仮定します。

インストールディレクトリ取得時にエラーが発生しました。

エラーメッセージを見て対処してください。

データディレクトリを取得できません。

関数 レジストリキー code =エラーコード

エラーメッセージ

C:¥Program Files¥Hitachi¥FTSFTPを仮定します。

履歴情報ディレクトリ取得時にエラーが発生しました。

エラーメッセージを見て対処してください。

一時ディレクトリを取得できません。

GetTempPath code =エラーコード

エラーメッセージ

一時ディレクトリの取得に失敗しました。

エラーメッセージを見て対処してください。

管理者で起動してください。

コマンドを起動したユーザが管理者ではありません。

コマンドを管理者で起動してください。

（凡例）

−：対処法はありません。

8.3.4　ftsloadコマンド実行時のメッセージ

ftsloadコマンドを実行したときに表示されるメッセージを次の表に示します。

表8‒8　ftsloadコマンド実行時のメッセージ

表示されるメッセージ

要因

対処法

ＪＰ１／ＦＴＰの定義情報を復元しました。

（正常終了）

−

ＪＰ１／ＦＴＰの定義情報保存ファイルではありません。

指定されたファイルは，JP1/FTPの定義情報保存ファイルではありません。

定義情報保存ファイルの指定を見直してください。

該当するユーザがないため復元する自動起動プログラム情報はありませんでした。

（警告付き正常終了）

−

コマンドラインの構文が誤っています。

コマンドラインの構文が誤っています。

コマンドラインの見直しをしてください。

スイッチが重複しています。

- オプション

オプションが重複しています。

オプションは重複しないように指定してください。

ファイル名の指定がありません。

復元する保存ファイル名の指定がありません。

復元する保存ファイル名を指定してください。

復元する定義情報がありません。

復元する定義情報が保存ファイルにありません。

−

無効なスイッチです。

- オプション

指定したオプションは無効です。

オプションの指定を見直してください。

管理者で起動してください。

コマンドを起動したユーザが管理者ではありません。

コマンドを管理者で起動してください。

（凡例）

−：対処法はありません。

8.3.5　ftssaveコマンド実行時のメッセージ

ftssaveコマンドを実行したときに表示されるメッセージを次の表に示します。

表8‒9　ftssaveコマンド実行時のメッセージ

表示されるメッセージ

要因

対処法

ＪＰ１／ＦＴＰの定義情報を保存しました。

（正常終了）

−

コマンドラインの構文が誤っています。

コマンドラインの構文が誤っています。

コマンドラインの見直しをしてください。

自動起動プログラム情報の登録情報はありません。

（警告付き正常終了）

−

スイッチが重複しています。

- オプション

オプションが重複しています。

オプションは重複しないように指定してください。

伝送情報の登録情報はありません。

（警告付き正常終了）

−

ファイル名が長すぎます。

ファイル名の指定が制限値を超えています。

ファイル名は，259バイト以内で指定してください。

ファイル名の指定がありません。

ファイル名が指定されていません。

ファイル名を指定してください。

無効なスイッチです。

- オプション

指定したオプションは無効です。

オプションの指定を見直してください。

ログインユーザ情報の登録情報はありません。

（警告付き正常終了）

−

管理者で起動してください。

コマンドを起動したユーザが管理者ではありません。

コマンドを管理者で起動してください。

（凡例）

−：対処法はありません。

8.4　アクセスログに出力されるメッセージ

アクセスログに出力されるメッセージの一覧を次の表に示します。

表8‒10　アクセスログに出力されるメッセージ

出力されるメッセージ

要因

FTPコマンド※1 is invalid because it was sent by a user who was not logged in. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

ログイン後に実行可能になるFTPコマンドを，ログイン前に受け付けました。

Login of user ユーザ名※5 failed. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

ログインに失敗しました。

The max. number of FTP clients was reached. No more clients can use the service.

最大同時伝送数を超える接続を受け付けました。

The connection was closed without login. [Remote host:IPアドレス※2][Remote port:ポート番号※3][Connection number:接続番号※4]

FTPクライアントが，ログインしないで接続を切断しました。

注※1

FTPコマンド：FTPコマンドを示します。

注※2

IPアドレス：FTPクライアントのIPアドレスを示します。

注※3

ポート番号：FTPクライアントのポート番号を示します。

注※4

接続番号：接続番号を示します。

注※5

ユーザ名：ユーザ名を示します。

9　トラブルシューティング

この章では，JP1/FTPでトラブルが生じたときの対処方法について説明します。

9.1　対処の手順

JP1/FTPでトラブルが起きた場合の，対処の手順を次に示します。

現象の確認

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。各メッセージの要因と対処方法については，「8.　メッセージ」を参照してください。また，JP1/FTPが出力するログ情報については，「9.2　ログ情報の種類」を参照してください。

資料の採取

トラブルの要因を調べるために資料の採取が必要です。「9.3　トラブル発生時に採取が必要な資料」を参照して，必要な資料を採取してください。

問題の調査

採取した資料を基に問題の要因を調査し，問題が発生している部分，または問題の範囲を切り分けてください。

9.2　ログ情報の種類

JP1/FTPを運用しているときに出力されるログ情報は，次の2種類あります。

共通メッセージログ

プロセス別ログ

この節では，2種類のログ情報について説明します。

9.2.1　共通メッセージログ

共通メッセージログとは，システム側のトラブルを通知する，システム管理者向けのログ情報のことです。共通メッセージログは，必要最小限のトラブル情報を通知します。

共通メッセージログは，Windowsイベントログに出力されます。

9.2.2　プロセス別ログ

プロセス別ログとは，JP1/FTPの各機能が出力するログ情報のことです。各機能によって異なるログファイルに出力されます。出力されるログファイルについては，「9.3.2 JP1/FTPに関する情報」を参照してください。

9.3　トラブル発生時に採取が必要な資料

JP1/FTPでトラブルが発生したときに採取が必要な資料と，採取方法を示します。

9.3.1　オペレーションシステム（OS）のログ情報

次に示すOSのログ情報の採取が必要です。

Windowsイベントログ

WindowsのイベントビューアでWindowsイベントログを確認してください。また，ファイルに出力してください。

9.3.2　JP1/FTPに関する情報

JP1/FTPに関する次の情報の採取が必要です。

表9‒1　JP1/FTPに関する情報

ファイル名

ディレクトリ名

概要

サイズ

管理方式

History※

履歴情報ディレクトリ

ファイル伝送の結果

環境定義の履歴情報保存件数 × 1,500バイト

ラップアラウンド

CSModuleTrace1〜64

履歴情報ディレクトリ¥trace

クライアントのモジュールトレース

環境定義のモジュールトレースのファイルサイズ

ラップアラウンド

SSModuleTrace1〜64

サーバのモジュールトレース

同上

ラップアラウンド

LSModuleTrace1〜4

ログサービスのモジュールトレース

同上

ラップアラウンド

CSProtocolTrace1〜60

クライアントのプロトコルトレース

環境定義のプロトコルトレースのファイルサイズ

ラップアラウンド

SSProtocolTrace1〜60

サーバのプロトコルトレース

同上

ラップアラウンド

ftsaccess.log[.old]

履歴情報ディレクトリ

アクセスログ

環境定義のアクセスログのファイルサイズ

2面管理

RegisterEventSource{1|2}.log

イベントログ出力失敗時のログファイル

1メガバイト

2面管理

ReportEvent{1|2}.log

DeregisterEventSource{1|2}.log

ftstran_trace

OSのインストールドライブ:¥ProgramData¥Hitachi¥FTSFTP¥trace

伝送コマンドトレース

2メガバイト

ラップアラウンド

ftsagent{1|2}.log

JP1/FTPのインストールディレクトリ¥manager¥trace

運用管理エージェントのモジュールトレース

1メガバイト

2面管理

ftsjnidll{1|2}.log

運用管理エージェントのモジュールトレース

1メガバイト

2面管理

ftsconsole{1|2}.log

運用管理コンソールのモジュールトレース

1メガバイト

2面管理

service1{1|2}.log

運用管理エージェントサービスのトレース

1メガバイト

2面管理

service2{1|2}.log

運用管理エージェントサービスのトレース

1メガバイト

2面管理

service3{1|2}.log

運用管理エージェントサービスのトレース

1メガバイト

2面管理

注※

履歴の保存件数を変更すると，旧履歴ファイルのバックアップを作成する場合があります。バックアップファイル名はFTSLOGSAVE，ディレクトリは履歴情報ディレクトリです。

9.3.3　JP1/FTPのプロセス一覧

Windowsのタスクマネージャでプロセスの動作状態を確認します。

Windowsのタスクマネージャを使って，プロセスの動作状態を確認してください。プロセスについては，「付録C　プロセス一覧」を参照してください。

9.3.4　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。記録しておいてください。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名）

9.3.5　画面上のエラー情報

画面にエラーが表示された場合は，その情報も採取します。次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー

［詳細］がある場合は，その内容をコピーしてください。

9.3.6　資料の採取方法

資料を採取するための採取ツールを用意しています。採取ツールを使用することで，採取の手間が軽減できます。

採取ツールの詳細を次に示します。

(1)　名称

FTSLOGCLCT.BAT

(2)　格納ディレクトリ

JP1/FTPのインストールディレクトリ

(3)　実行形式

FTSLOGCLCT.BAT[△/D△履歴情報ディレクトリ]△採取先ディレクトリ

△は半角空白を示します。

(4)　機能

次に示す資料を採取先ディレクトリ以下にコピーします。

製品情報

定義情報

「9.3.2　JP1/FTPに関する情報」に示した資料

(5)　引数

履歴情報ディレクトリ

履歴情報ディレクトリを指定します。

省略した場合は，環境定義で定義されている履歴情報ディレクトリとなります。

採取先ディレクトリ

障害情報の採取先のディレクトリを指定します。

ディレクトリが存在しない場合は，新規に作成します。

ディレクトリが存在する場合は，上書きします。

(6)　実行権限

管理者

(7)　注意事項

採取ツールをカスタマイズしたい場合は，任意のディレクトリにコピーしてカスタマイズしてください。

付録

付録A　ファイルおよびディレクトリ一覧

JP1/FTPで使用するファイル名およびディレクトリ名を次の表に示します。なお，デフォルトのディレクトリは，次のとおりです。

JP1/FTPのインストールディレクトリ

製品本体：

OSのインストールドライブ:¥Program Files(x86)¥Hitachi¥FTSFTP

64ビット用APIライブラリ：

OSのインストールドライブ:¥Program Files¥Hitachi¥FTSFTP

履歴情報ディレクトリ

OSのインストールドライブ:¥Program Files(x86)¥Hitachi¥FTSFTP

表A‒1　JP1/FTPのファイルおよびディレクトリ一覧

内容

ファイル名・ディレクトリ名

コマンド

伝送実行

JP1/FTPのインストールディレクトリ¥ftstran.exe

伝送情報の登録・変更・削除・表示

JP1/FTPのインストールディレクトリ¥ftsregc.exe

履歴情報の表示

JP1/FTPのインストールディレクトリ¥ftshistory.exe

定義情報の保存

JP1/FTPのインストールディレクトリ¥ftssave.exe

定義情報の復元

JP1/FTPのインストールディレクトリ¥ftsload.exe

定義情報ファイル

ポート番号設定ファイルのサンプル

JP1/FTPのインストールディレクトリ¥services.sample

環境定義ファイル

JP1/FTPのインストールディレクトリ¥ftsenv.ini

環境定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥ftsenv.ini.sample

PASV伝送定義ファイル

JP1/FTPのインストールディレクトリ¥FTPPASV.INI

PASV伝送定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥FTPPASV.INI.SAMPLE

接続ホスト制限定義ファイル

JP1/FTPのインストールディレクトリ¥FTPHOSTACC.INF

接続ホスト制限定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥FTPHOSTACC.INF.sample

複数IPアドレス環境定義ファイル

JP1/FTPのインストールディレクトリ¥HOSTINFO.INI

複数IPアドレス環境定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥HOSTINFO.INI.sample

アクセス制限機能での絶対パス名のルートディレクトリの変更定義ファイル

JP1/FTPのインストールディレクトリ¥AccessLimitation.ini

アクセス制限機能での絶対パス名のルートディレクトリの変更定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥AccessLimitation.ini.sample

FTP接続応答メッセージの情報抑止定義ファイル

JP1/FTPのインストールディレクトリ¥FtsBanner.ini

FTP接続応答メッセージの情報抑止定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥FtsBanner.ini.sample

FTP接続応答メッセージファイル

JP1/FTPのインストールディレクトリ¥FtsBanner.txt

IPv6環境定義ファイル

JP1/FTPのインストールディレクトリ¥IPversion.ini

IPv6環境定義ファイルのサンプル

JP1/FTPのインストールディレクトリ¥IPversion.ini.sample

履歴情報ファイル

履歴ファイル

履歴情報ディレクトリ¥History

履歴ファイルのバックアップ※

履歴情報ディレクトリ¥FTSLOGSAVE

クライアントのモジュールトレース

履歴情報ディレクトリ¥trace¥CSModuleTrace1〜64

サーバのモジュールトレース

履歴情報ディレクトリ¥trace¥SSModuleTrace1〜64

ログサービスのモジュールトレース

履歴情報ディレクトリ¥trace¥LSModuleTrace1〜4

クライアントのプロトコルトレース

履歴情報ディレクトリ¥trace¥CSProtocolTrace1〜60

サーバのプロトコルトレース

履歴情報ディレクトリ¥trace¥SSProtocolTrace1〜60

アクセスログファイル

履歴情報ディレクトリ¥ftsaccess.log

アクセスログファイルのバックアップ

履歴情報ディレクトリ¥ftsaccess.log.old

イベントログ出力失敗時のログファイル

履歴情報ディレクトリ¥RegisterEventSource1〜2.log

履歴情報ディレクトリ¥ReportEvent1〜2.log

履歴情報ディレクトリ¥DeregisterEventSource1〜2.log

伝送コマンドトレース

OSのインストールドライブ:¥ProgramData¥Hitachi¥FTSFTP¥trace¥ftstran_trace

テキスト出力のフォーマットファイル

ログインユーザ登録情報

JP1/FTPのインストールディレクトリ¥Form¥en¥USFORM.TXT

JP1/FTPのインストールディレクトリ¥Form¥ja¥USFORM.TXT

ログインユーザ登録情報のサンプル

JP1/FTPのインストールディレクトリ¥Form¥en¥USFORM.TXT.sample

JP1/FTPのインストールディレクトリ¥Form¥ja¥USFORM.TXT.sample

自動起動プログラム情報

JP1/FTPのインストールディレクトリ¥Form¥en¥ATFORM.TXT

JP1/FTPのインストールディレクトリ¥Form¥ja¥ATFORM.TXT

自動起動プログラム情報のサンプル

JP1/FTPのインストールディレクトリ¥Form¥en¥ATFORM.TXT.sample

JP1/FTPのインストールディレクトリ¥Form¥ja¥ATFORM.TXT.sample

伝送要求登録情報

JP1/FTPのインストールディレクトリ¥Form¥en¥CLFORM.TXT

JP1/FTPのインストールディレクトリ¥Form¥ja¥CLFORM.TXT

伝送要求登録情報のサンプル

JP1/FTPのインストールディレクトリ¥Form¥en¥CLFORM.TXT.sample

JP1/FTPのインストールディレクトリ¥Form¥ja¥CLFORM.TXT.sample

履歴情報

JP1/FTPのインストールディレクトリ¥Form¥en¥HSFORM.TXT

JP1/FTPのインストールディレクトリ¥Form¥ja¥HSFORM.TXT

履歴情報のサンプル

JP1/FTPのインストールディレクトリ¥Form¥en¥HSFORM.TXT.sample

JP1/FTPのインストールディレクトリ¥Form¥ja¥HSFORM.TXT.sample

APIライブラリ

インポートライブラリ（VS2012用）

JP1/FTPのインストールディレクトリ¥FTSFTP110*.lib

インポートライブラリ（VS2013用）

JP1/FTPのインストールディレクトリ¥FTSFTP120*.lib

ヘッダファイル

JP1/FTPのインストールディレクトリ¥apihead.h

サンプルプログラム

JP1/FTPのインストールディレクトリ¥Sample.c

運用管理

管理ホスト定義情報

JP1/FTPのインストールディレクトリ¥manager¥console¥hostdef.csv

運用管理コンソールモジュールトレース

JP1/FTPのインストールディレクトリ¥manager¥trace¥ftsconsole1〜2.log

運用管理エージェントモジュールトレース

JP1/FTPのインストールディレクトリ¥manager¥trace¥ftsagent1〜2.log

JP1/FTPのインストールディレクトリ¥manager¥trace¥ftsjnidll1〜2.log

運用管理エージェントサービスのトレース

JP1/FTPのインストールディレクトリ¥manager¥trace¥service11〜2.log

JP1/FTPのインストールディレクトリ¥manager¥trace¥service21〜2.log

JP1/FTPのインストールディレクトリ¥manager¥trace¥service31〜2.log

ユーティリティ

資料採取ツール

JP1/FTPのインストールディレクトリ¥FTSLOGCLCT.BAT

伝送結果初期化ツール

JP1/FTPのインストールディレクトリ¥FTSTRANINIT.BAT

運用管理初期化ツール

JP1/FTPのインストールディレクトリ¥manager¥FTSMGRINIT.BAT

管理ホスト情報変更ツール

JP1/FTPのインストールディレクトリ¥manager¥console¥FTSMGRHOST.BAT

修正パッチ情報

ログファイル

JP1/FTPのインストールディレクトリ¥PATCHLOG.TXT

バックアップディレクトリ

JP1/FTPのインストールディレクトリ¥patch_backup_dir

注※

履歴情報保存件数を変更すると，旧履歴ファイルのバックアップを作成する場合があります。

付録B　ポート番号

JP1/FTPが使用するポート番号とファイアウォールを通過するための方向を示します。なお，使用するプロトコルは，TCP/IPです。

付録B.1　ポート番号一覧

各ポート番号は，JP1/FTPのインストール後に設定します。ポート番号は，任意に設定でき，次の表に示すポート番号は設定例です。設定については，「2.2.3 ポート番号を設定する」を参照してください。

表B‒1　JP1/FTPのポート番号一覧

サービス名

ポート番号（例）

用途

ftssdata

20124

着信データ転送用に使用（FTPのデータコネクション）

ftss

20125

着信のポートとして使用（FTPの制御コネクション）

ftsc

20126

クライアントサービスで使用

ftsclog

20127

JP1/FTPのロギングで使用

ftsslog

20128

JP1/FTPのロギングで使用

ftsagent

20252

運用管理機能で使用

付録B.2　ファイアウォールの通過方向

ファイアウォールの通過方向を，次の表に示します。

表B‒2　ファイアウォールの通過方向（ACTVモード）

コネクション種別

サーバ側製品

ポート番号（例）

ファイアウォールの通過方向

クライアント側製品

ポート番号

制御コネクション

JP1/FTP

20125/tcp

←

JP1/FTP※

ANY/tcp

データコネクション

JP1/FTP

20124/tcp

→

JP1/FTP※

ANY/tcp

表B‒3　ファイアウォールの通過方向（PASVモード）

コネクション種別

サーバ側製品

ポート番号（例）

ファイアウォールの通過方向

クライアント側製品

ポート番号

制御コネクション

JP1/FTP

20125/tcp

←

JP1/FTP※

ANY/tcp

データコネクション

JP1/FTP

ANY/tcp

←

JP1/FTP※

ANY/tcp

注※

クライアント側製品がJP1/FTPでない場合には，ポート番号はその製品に依存します。

ANYは，OSによって割り当てられる空きポート番号を使用することを意味します。この場合に使用するポート番号の範囲は，OSによって異なります。

付録B.3　ファイアウォール経由で伝送をする場合の確認方法

ファイアウォール経由でファイル伝送をする場合は，次のことを確認してください。

ファイアウォールがFTPプロトコルを透過できるかどうかを，ファイアウォール側に確認する。

YES→2へ

NO→FTPプロトコルを透過できるファイアウォールへの変更を検討してください。

OS標準のFTPも使用するかどうかを確認する。

YES→3へ

NO→ftssdataとftssを通常のFTPで使用するポート番号に変更してください。

ftssdata：20/TCP

ftss：21/TCP

ファイアウォールの設定で，FTPのポートを追加できるかどうかを，ファイアウォール側に確認する。

YES→ftssdataとftssをFTPのポートとして使用できるように，ファイアウォールで設定してください。

NO→標準のFTPも使用する場合，JP1/FTPは使用できません。

注意事項

運用管理コンソールと運用管理エージェントとの間でIPアドレスの変換が行われる環境では，運用管理機能を使用できません。

付録C　プロセス一覧

JP1/FTPのプロセスを次に示します。

プロセスは，［タスクマネージャ］ウィンドウの［プロセス］タブで確認できます。

JP1/FTPのプロセスの一覧を次の表に示します。なお，表内の（ ）内の数値は，同時に実行できるプロセス数です。

表C‒1　JP1/FTPのプロセス一覧

プロセス名

機能

ftpd(1)

サーバサービス

ftpcs(1)

クライアントサービス

ftpl(1)

ログサービス

ftsagent(1)

エージェントサービス

付録D　JP1イベント

JP1/FTPが出力するJP1イベントの一覧と属性を次に示します。

付録D.1　JP1イベントの一覧

表D‒1　JP1イベント一覧

イベントID

発行契機

メッセージ

00010D01

JP1/File Transmission Server/FTP Serverサービスの開始

ＦＴＰＳｅｒｖｅｒが開始しました

00010D02

JP1/File Transmission Server/FTP Clientサービスの開始

ＦＴＰＣｌｉｅｎｔが開始しました

00010D03

JP1/File Transmission Server/FTP Logサービスの開始

ＦＴＰＬｏｇが開始しました

00010D0F

JP1/File Transmission Server/FTP Agentサービスの開始

ＦＴＰＡｇｅｎｔが開始しました

00010D04

JP1/File Transmission Server/FTP Serverサービスの停止

ＦＴＰＳｅｒｖｅｒが終了しました

00010D05

JP1/File Transmission Server/FTP Clientサービスの停止

ＦＴＰＣｌｉｅｎｔが終了しました

00010D06

JP1/File Transmission Server/FTP Logサービスの停止

ＦＴＰＬｏｇが終了しました

00010D10

JP1/File Transmission Server/FTP Agentサービスの停止

ＦＴＰＡｇｅｎｔが終了しました

00010D0B

ファイル伝送の正常終了時

ＦＴＰファイル伝送が正常終了しました

00010D0C

ファイル伝送の異常終了時

ＦＴＰファイル伝送が異常終了しました

00010D0D

ファイル伝送の警告終了時（自動起動プログラムの起動失敗）

ＦＴＰファイル伝送が警告終了しました

プログラムの自動起動に失敗しました

付録D.2　JP1イベントの属性

JP1イベントの詳細をイベントID別に示します。

(1)　イベントID:00010D01の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＳｅｒｖｅｒが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザ名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

SERVER

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/SERVER

オブジェクトID

OBJECT_ID

SERVER

事象種別

OCCURRENCE

START

開始時刻

START_TIME

開始時刻

終了時刻

END_TIME

−

終了コード

RESULT_CODE

−

（凡例）

−：該当する情報はありません。

(2)　イベントID:00010D02の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＣｌｉｅｎｔが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

CLIENT

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/CLIENT

オブジェクトID

OBJECT_ID

CLIENT

事象種別

OCCURRENCE

START

開始時刻

START_TIME

開始時刻

終了時刻

END_TIME

−

終了コード

RESULT_CODE

−

（凡例）

−：該当する情報はありません。

(3)　イベントID:00010D03の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰLｏｇが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

LOG

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/LOG

オブジェクトID

OBJECT_ID

LOG

事象種別

OCCURRENCE

START

開始時刻

START_TIME

開始時刻

終了時刻

END_TIME

−

終了コード

RESULT_CODE

−

（凡例）

−：該当する情報はありません。

(4)　イベントID:00010D0Fの詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＡｇｅｎｔが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

AGENT

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/AGENT

オブジェクトID

OBJECT_ID

AGENT

事象種別

OCCURRENCE

START

開始時刻

START_TIME

開始時刻

終了時刻

END_TIME

−

終了コード

RESULT_CODE

−

（凡例）

−：該当する情報はありません。

(5)　イベントID:00010D04の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＳｅｒｖｅｒが終了しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

SERVER

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/SERVER

オブジェクトID

OBJECT_ID

SERVER

事象種別

OCCURRENCE

END

開始時刻

START_TIME

−

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

0

（凡例）

−：該当する情報はありません。

(6)　イベントID:00010D05の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＣｌｉｅｎｔが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

CLIENT

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/CLIENT

オブジェクトID

OBJECT_ID

CLIENT

事象種別

OCCURRENCE

END

開始時刻

START_TIME

−

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

0

（凡例）

−：該当する情報はありません。

(7)　イベントID:00010D06の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＬｏｇが開始しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

LOG

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/LOG

オブジェクトID

OBJECT_ID

LOG

事象種別

OCCURRENCE

END

開始時刻

START_TIME

−

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

0

（凡例）

−：該当する情報はありません。

(8)　イベントID:00010D10の詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰＡｇｅｎｔが終了しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

サービスを起動したユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

AGENT

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/AGENT

オブジェクトID

OBJECT_ID

AGENT

事象種別

OCCURRENCE

END

開始時刻

START_TIME

−

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

0

（凡例）

−：該当する情報はありません。

(9)　イベントID:00010D0Bの詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰファイル伝送が正常終了しました

拡張属性

（共通情報）

重大度

SEVERITY

Information

ユーザー名

USER_NAME

FTPログインユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

SERVERの場合：Transmission Number（伝送番号）

CLIENTの場合：伝送カード名

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/SERVERまたはJP1/FTP/CLIENT

オブジェクトID

OBJECT_ID

SERVERまたはCLIENT

事象種別

OCCURRENCE

END

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

0

（固有情報）

伝送番号

A0

伝送番号

接続番号

A1

接続番号

カード名

A2

伝送カード名（クライアントだけ）

接続先ホスト名

A3

接続先ホスト名

接続先ポート番号

A4

接続先ポート番号（クライアントだけ）

ユーザ名

A5

FTPログインユーザー名

伝送モード

A6

ASCIIまたはBINARY

伝送コマンド

A7

送信（上書），送信（追加），受信（上書），または受信（追加）

圧縮モード

A8

圧縮または非圧縮

ローカルファイル名

A9

ローカルファイル名

リモートファイル名

B0

リモートファイル名（クライアントだけ）

伝送開始番号

B1

伝送開始時間

伝送終了時間

B2

伝送終了時間

伝送データサイズ

B3

伝送データサイズ（バイト）

コメント

B4

コメント（クライアントだけ）

伝送終了状態

B5

正常終了

（凡例）

−：該当する情報はありません。

(10)　イベントID:00010D0Cの詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰファイル伝送が異常終了しました

拡張属性

（共通情報）

重大度

SEVERITY

Error

ユーザー名

USER_NAME

FTPログインユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

SERVERの場合：Transmission Number（伝送番号）

CLIENTの場合：伝送カード名

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/SERVERまたはJP1/FTP/CLIENT

オブジェクトID

OBJECT_ID

SERVERまたはCLIENT

事象種別

OCCURRENCE

END

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

1

（固有情報）

伝送番号

A0

伝送番号

接続番号

A1

接続番号

カード名

A2

伝送カード名（クライアントだけ）

接続先ホスト名

A3

接続先ホスト名

接続先ポート番号

A4

接続先ポート番号（クライアントだけ）

ユーザ名

A5

FTPログインユーザー名

伝送モード

A6

ASCIIまたはBINARY

伝送コマンド

A7

送信（上書），送信（追加），受信（上書），または受信（追加）

圧縮モード

A8

圧縮または非圧縮

ローカルファイル名

A9

ローカルファイル名

リモートファイル名

B0

リモートファイル名（クライアントだけ）

伝送開始番号

B1

伝送開始時間

伝送終了時間

B2

伝送終了時間

伝送データサイズ

B3

伝送データサイズ（バイト）

コメント

B4

コメント（クライアントだけ）

伝送終了状態

B5

異常終了

エラー発生モジュール

C0

エラー発生モジュール

エラー発生場所

C1

エラー発生場所

エラー種別

B6

システムコールエラー，論理エラー，プロトコルエラー

システムコール名

B7

エラー発生システムコール名（エラー種別：システムコールエラー）

システムコールメッセージ

B8

システムコールエラーメッセージ（エラー種別：システムコールエラー）

プロトコルメッセージ

B9

プロトコルエラーメッセージ（エラー種別：プロトコルエラー）

（凡例）

−：該当する情報はありません。

(11)　イベントID:00010D0Dの詳細

属性種別

項目

属性名

内容

基本属性

メッセージ

−

ＦＴＰファイル伝送が警告終了しました

プログラムの自動起動に失敗しました

拡張属性

（共通情報）

重大度

SEVERITY

Warning

ユーザー名

USER_NAME

FTPログインユーザー

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/FTP

オブジェクトタイプ

OBJECT_TYPE

JOB

オブジェクト名

OBJECT_NAME

SERVERの場合：Transmission Number（伝送番号）

CLIENTの場合：伝送カード名

登録名タイプ

ROOT_OBJECT_TYPE

JOB

登録名

ROOT_OBJECT_NAME

JP1/FTP/SERVERまたはJP1/FTP/CLIENT

オブジェクトID

OBJECT_ID

SERVERまたはCLIENT

事象種別

OCCURRENCE

END

終了時刻

END_TIME

終了時刻

終了コード

RESULT_CODE

2

（固有情報）

伝送番号

A0

伝送番号

接続番号

A1

接続番号

カード名

A2

伝送カード名（クライアントだけ）

接続先ホスト名

A3

接続先ホスト名

接続先ポート番号

A4

接続先ポート番号（クライアントだけ）

ユーザ名

A5

FTPログインユーザー名

伝送モード

A6

ASCIIまたはBINARY

伝送コマンド

A7

送信（上書），送信（追加），受信（上書），または受信（追加）

圧縮モード

A8

圧縮または非圧縮

ローカルファイル名

A9

ローカルファイル名

リモートファイル名

B0

リモートファイル名（クライアントだけ）

伝送開始番号

B1

伝送開始時間

伝送終了時間

B2

伝送終了時間

伝送データサイズ

B3

伝送データサイズ（バイト）

コメント

B4

コメント（クライアントだけ）

伝送終了状態

B5

正常終了

自動起動プログラム名

C3

自動起動プログラム名

（凡例）

−：該当する情報はありません。

付録E　定義情報を出力するフォーマットファイルについて

定義情報を出力するフォーマットファイルについて説明します。

フォーマットファイルは，あらかじめサンプルのファイルが設定されています。サンプルフォーマットのファイル格納場所とファイル名については，「付録A ファイルおよびディレクトリ一覧」を参照してください。

フォーマットファイルは，出力内容を指定するなど，使いやすいように変更できます。

付録E.1　フォーマットファイルの作成

フォーマットファイルに出力する情報は，キーワードで指定します。

出力時に，フォーマットファイル上のキーワードのある位置に該当する情報が埋め込まれます。キーワード以外の文字（改行などの制御文字を含む）は，そのままテキストファイルに出力されます。

作成時の注意

フォーマットファイルは2,048バイト以内で作成してください。2,048バイトを超えてファイルを作成した場合，2,048バイト以降の情報は無視されます。

フォーマットファイルに記述できるキーワードの数は最大50個です。50個を超えた場合，51個以降のキーワードは無効となり，キーワードとして扱われません。

(1)　指定できるキーワード

各フォーマットファイルで指定できるキーワードを示します。

表E‒1　ログインユーザ定義情報で指定できるキーワード

キーワード

内容

$ICNT

情報カウント

$USER

ユーザ名

$CDIR

カレントディレクトリ

表E‒2　自動起動プログラム情報で指定できるキーワード

キーワード

内容

$ICNT

情報カウント

$USER

ユーザ名

$AKEY

自動起動キー

$AFDK

キー種別

$ANML

正常時起動プログラム名

$AERR

異常時起動プログラム名

表E‒3　伝送情報で指定できるキーワード

キーワード

内容

$ICNT

情報カウント

$USER

ユーザ名

$PSWD

パスワード

$CARD

伝送カード

$LCAL

ローカルファイル名

$RMTE

リモートファイル名

$TRAN

送受信種別

$MODE

伝送モード

$OUTK

出力種別

$COMP

圧縮モード

$FSIZ

サイズ確認

$HOST

相手ホスト名

$PORT

ポート番号

$ANML

正常時起動プログラム名

$AERR

異常時起動プログラム名

$CMND

FTPコマンド

$CMNT

コメント

$MULT

単／複伝送

表E‒4　履歴情報で指定できるキーワード

キーワード

内容

$ICNT

情報カウント

$USER

ユーザ名

$CARD

伝送カード

$LCAL

ローカルファイル名

$RMTE

リモートファイル名

$TRAN

送受信種別

$MODE

伝送モード

$OUTK

出力種別

$COMP

圧縮モード

$HOST

相手ホスト名

$PORT

ポート番号

$CMNT

コメント

$TRNO

伝送番号

$SVCE

発着信種別

$STAT

終了状態

$STIM

開始時刻

$ETIM

終了時刻

$TIME

伝送時間

$TSIZ

伝送サイズ

$CONO

接続番号

$ETYP

エラー種別

$EPOS

エラー発生位置

$EMOD

エラーモジュール名

$ESYS

システムコール名

$EMSG

エラーメッセージ

$EPRT

プロトコルメッセージ

付録F　ツール

JP1/FTPで使用できるツールの一覧を次に示します。

表F‒1　JP1/FTPで使用できるツール

機能

ツール名

初期化する

FTSTRANINIT.BAT

FTSMGRINIT.BAT

管理ホスト情報を変更する

FTSMGRHOST.BAT

付録F.1　FTSTRANINIT.BAT, FTSMGRINIT.BAT −初期化−

伝送の結果（履歴情報，トレース情報，伝送番号，接続番号）または運用管理機能の動作結果（トレース情報）を初期状態に戻します。

(1)　名称

FTSTRANINIT.BAT

FTSMGRINIT.BAT

(2)　格納ディレクトリ

FTSTRANINIT.BAT：

JP1/FTPのインストールディレクトリ

FTSMGRINIT.BAT：

JP1/FTPのインストールディレクトリ¥manager

(3)　実行形式

FTSTRANINIT.BAT

FTSMGRINIT.BAT

(4)　機能

FTSTRANINIT.BAT：

次のように，伝送結果が初期化されます。

履歴情報が削除される

プロトコルトレースが削除される

モジュールトレースが削除される

伝送番号が初期値に戻る

接続番号が初期値に戻る

アクセスログファイルが初期化（0バイト）される

FTSMGRINIT.BAT：

運用管理用のトレース情報が削除されます。

(5)　引数

なし。

(6)　実行権限

管理者

(7)　注意事項

FTSTRANINIT.BAT：

実行前にJP1/FTPのクライアントサービス，サーバサービス，およびログサービスを停止させてください。

FTSMGRINIT.BAT：

実行前にJP1/FTPのエージェントサービスの停止および運用管理コンソールを閉じてください。

付録F.2　FTSMGRHOST.BAT −管理ホスト情報の変更−

管理ホスト情報で，自局ホストを追加または削除します。

(1)　名称

FTSMGRHOST.BAT

(2)　格納ディレクトリ

JP1/FTPのインストールディレクトリ¥manager¥console

(3)　実行形式

FTSMGRHOST.BAT /A | /D

(4)　機能

管理ホスト情報で，自局ホストの情報を変更します。

(5)　引数

/A

管理ホスト情報で，自局ホストの情報を追加することを指定します。

/D

管理ホスト情報で，自局ホストの情報を削除することを指定します。

(6)　実行権限

管理者

付録G　使用上の注意事項

JP1/FTPのコマンド，GUI，ツールを起動時，管理者で実行してください。

なお，管理者とは，次の条件を満たしていることが前提になります。

ユーザアカウント制御（UAC）が有効の場合

Administratorまたは管理者特権へ昇格したユーザー

ユーザアカウント制御（UAC）が無効の場合

Administrators権限を持つユーザー

ほかの連携製品からJP1/FTPを起動する場合，連携製品が管理者で実行されていないと，JP1/FTPの起動が失敗する場合があります。

ファイル伝送中には，該当ファイルに対して排他処理をしています。送信の場合には，該当ファイルに対して読み出しはできますが，書き込みはできません。受信の場合には，該当ファイルに対して読み出しも書き込みもできません。

ファイル受信中の強制終了や伝送エラーなどで伝送が中断した場合，不完全なファイルが作成される場合があります。上書きで受信中に中断しても，ファイルは元に戻りません。

JP1/FTPでは，ネットワークドライブのファイルも単なるWindowsの1ファイルとして扱いますので，Windowsのファイルとして正常に扱える環境または操作の範囲内で使用してください。

なお，伝送処理が正常に終了しても，ネットワークドライブ固有の問題，また，その設定や環境構築上の問題によって，伝送ファイルの内容が正常に書き込まれない場合があります。

IPアドレスの変換（NAT変換やIPマスカレードなど）を行うネットワーク中継機器（ルータやファイアウォールなど）を使用している場合は，FTPプロトコル上，それらを経由したファイル伝送ができないときがあります。使用している機器がFTPプロトコルに対応しているか確認してください。

JP1/FTPで使用するIPアドレスは次のとおりになります。

表G‒1　使用するIPアドレス

項番

用途

使用するIPアドレス

1

クライアント

制御コネクションのIPアドレス

OSが自動的に割り当てるIPアドレス

2

データコネクションのIPアドレス

制御コネクションのIPアドレス

3

サーバ

制御コネクションのIPアドレス

接続を受け付けたIPアドレス

4

データコネクションのIPアドレス

制御コネクションのIPアドレス

5

運用管理エージェントのIPアドレス

物理IPアドレス（OSのコマンドhostnameなどで返されるホスト名に対応するIPアドレス）

6

運用管理コンソールのIPアドレス

OSが自動的に割り当てるIPアドレス

JP1/FTPをクラスタシステム（HA構成の系切り替え）構成で使用する場合の注意事項を次に示します。論理アドレスを使用する環境でのJP1/FTPの定義については，「3.11 複数IPアドレス環境での使用」を参照してください。なお，クラスタシステムとは，これまでJP1のマニュアルで「系切り替えシステム」と呼ばれていたものと同じです。

フェールオーバには対応していません。

物理IPアドレス（OSのコマンドhostnameなどで返されるホスト名に対応するIPアドレス）は有効にしてください。

クラスタソフトから，JP1/FTPのサービスを起動および停止することは可能です。

JP1/FTPがFTPサーバ（着信）として動作する場合，FTPクライアント（発信）が接続先に論理IPアドレスを指定しても，物理IPアドレスを指定してもファイル伝送は可能です。

JP1/FTPがFTPクライアント（発信側）として動作する場合，障害時にはファイル伝送の自動リトライなどによる再伝送は行いません。

FTPカスタムジョブによるファイル伝送は可能です。

また，複数IPアドレス用環境定義を使用しないときの注意事項を次に示します。

JP1/FTPがFTPクライアント（発信）として動作する場合，コネクションのIPアドレスはOSが自動的に割り当てるため，通常は物理IPアドレスとなります。

JP1イベントは，物理IPアドレス（OSのコマンドhostnameなどで返されるホスト名に対応するIPアドレス）に送ります。

JP1/FTPがFTPサーバ（着信）として動作する場合，制御コネクションの接続時に返す220メッセージ内のホスト名は物理ホスト名（OSのコマンドhostnameなどで返されるホスト名）となります。

第三水準文字および第四水準文字には対応していません。

システム時刻を変更する場合は，JP1/FTPのサービス，GUIなどをすべて停止してから変更してください。また，システム時刻を戻す場合は，伝送履歴を初期化する必要があります。

システム時刻を戻す方法を次に示します。

1. JP1/FTPのサービス，GUIなどをすべて停止する。

2. 履歴情報ファイルを任意のディレクトリにバックアップする。

3. システムの時刻を変更する。

4. 伝送結果を初期化する。初期化の方法については，「付録F.1　FTSTRANINIT.BAT, FTSMGRINIT.BAT −初期化−」を参照してください。

5. JP1/FTPのサービス，GUIなどを起動する。

付録H　各バージョンの変更内容

各バージョンの変更内容を示します。

付録H.1　11-00の変更内容

言語選択ダイアログを追加した。

モジュールトレースのファイルの面数を変更した。

JP1/Cm2/NNM連携機能を廃止した。

FTP接続応答メッセージ内の日付の表示形式を変更した。

カスタムジョブ定義プログラムの環境設定ファイルの設定方法を追加した。

fts_ftp_syn_request関数，fts_ftp_asyn_request関数，fts_ftp_event関数を廃止した。

接続情報構造体の形式を変更した。

APIライブラリが前提とするコンパイラーの情報を変更した。

64ビット用のAPIライブラリを追加した。

トラブル発生時に採取が必要な資料にログサービスのモジュールトレースを追加した。

付録H.2　10-10の変更内容

FTPHOSTACC.INFにIPv6アドレスを指定できるようにした。

伝送終了時のJP1イベント送信先を指定できるようにした。

APIライブラリが前提とするコンパイラーの情報を変更した。

ftstranコマンドを一般ユーザが実行できるようにした。

イベントビューアに表示されるメッセージに，イベントID=39，40，41，42を追加した。

付録H.3　10-00の変更内容

IPv6アドレスでファイル伝送をできるようにした。

次の設定項目のデフォルト値および最大値を変更した。

履歴情報保存件数

プロトコルトレースのファイルサイズ

モジュールトレースのファイルサイズ

FTPクライアント側でのPASVコマンドのチェック仕様を変更した。

運用管理コンソールでの4ギガバイトを超えた履歴情報表示の制限を解除した。

カスタムジョブの登録に必要なDLLファイルの情報を変更した。

fts_ftp_open_ex関数を追加した。

10-00より前のバージョンで使用していたAPIライブラリを10-00以降のバージョンで使用する場合の注意事項を追加した。

APIライブラリが前提とするコンパイラーの情報を変更した。

イベントビューアに表示されるメッセージに，イベントID=37，38を追加した。

付録H.4　09-00の変更内容

管理者または管理者権限のあるユーザ以外のユーザが，定義情報の内容を参照できるようにした。

FTPサーバ側でのPORTコマンドのチェック仕様を変更しました。

ftstranコマンドの戻り値（9900001）を追加した。

ftsregcコマンドの戻り値（9900001）を追加した。

ftshistoryコマンドの戻り値（9900001）を追加した。

fts_ftp_open関数の戻り値（0x2FFFFF13）を追加した。

ftstranコマンド実行時のメッセージを追加した。

ftsregcコマンド実行時のメッセージを追加した。

ftshistoryコマンド実行時のメッセージを追加した。

ftsloadコマンド実行時のメッセージを追加した。

ftssaveコマンド実行時のメッセージを追加した。

Windows Server 2008使用時の注意事項を追加した。

付録I　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録I.1　関連マニュアル

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

JP1 Version 11 JP1/Base 運用ガイド（3021-3-A01）

JP1 Version 11 JP1/Integrated Management - Manager 構築ガイド（3021-3-A08）

JP1 Version 11 JP1/Automatic Job Management System 3 連携ガイド（3021-3-B20）

JP1 Version 10 JP1/NETM/DM 運用ガイド1(Windows(R)用)（3021-3-177）

付録I.2　このマニュアルでの表記

このマニュアルで使用する表記と，対応する製品名を次の表に示します。

表記

製品名

JP1/AJS3

JP1/AJS - Manager

JP1/Automatic Job Management System 3 - Manager

JP1/AJS - View

JP1/Automatic Job Management System 3 - View

JP1/FTP

JP1/File Transmission Server/FTP

JP1/IM

JP1/IM - Manager

JP1/Integrated Management - Manager

JP1/IM - View

JP1/Integrated Management - View

付録I.3　英略語

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

英略語

正式名称

API

Application Programming Interface

DNS

Domain Name System

LAN

Local Area Network

NIC

Network Interface Card

RFC

Request for Comments

TCP/IP

Transmission Control Protocol/Internet Protocol

WAN

Wide Area Network

付録I.4　記号

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

(1)　値の指定で使用する記号

値の指定で使用する記号を次の表に示します。

記号

説明

(( ))

指定できる値の範囲を示します。

《 》

デフォルト値を示します。

(2)　コマンドおよび関数の文法で使用する記号

コマンド，または関数の説明で使用する記号を次の表に示します。

記号

意味

|（ストローク）

複数の項目に対し，項目間の区切りを示し，「または」の意味を示します。

（例）

「A | B | C」は，「A，BまたはC」を示します。

{　}（波括弧）

この記号で囲まれている複数の項目の中から，必ず1組の項目を選択します。

（例）

{A|B|C}は「A，BまたはCのどれかを指定する」ことを示します。

[　]（角括弧）

この記号で囲まれている項目は任意に指定できます(省略できます)。

（例）

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

[B|C]は「何も指定しない」か「BまたはCを指定する」ことを示します。

＿（下線）

括弧内のすべてを省略したときに，システムがとる標準値を示します。

（例）

[A|B]はこの項目を指定しなかった場合，システムはAを選択したと見なすことを示します。

太字

太字で表記している項目は，任意に指定する項目であることを示します。

付録I.5　KB（キロバイト）などの単位表記について

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

索引

A

AccessLimitation.ini[1]

APIライブラリ[1]

F

FTPHOSTACC.INF[1]

FTPPASV.INI[1]

FTP接続応答メッセージの情報抑止機能[1]

fts_ftp_asyn_request_ex()[1]

fts_ftp_cancel()[1]

fts_ftp_close()[1]

fts_ftp_event_ex()[1]

fts_ftp_open_ex()[1]

fts_ftp_syn_request_ex()[1]

FtsBanner.ini[1]、[2]

FtsBanner.txt[1]、[2]、[3]

ftshistory（履歴情報の表示）[1]

ftshistoryコマンド実行時のメッセージ[1]

ftsload（定義情報の復元）[1]

ftsloadコマンド実行時のメッセージ[1]

ftsregc（伝送情報の登録・変更・削除・表示）[1]

ftsregcコマンド実行時のメッセージ[1]

ftssave（定義情報の保存）[1]

ftssaveコマンド実行時のメッセージ[1]

ftstran（伝送の実行）[1]

ftstranコマンド実行時のメッセージ[1]

H

HOSTINFO.INI[1]

I

IPv6環境での使用[1]

IPversion.ini[1]

J

JP1/AJS3との連携[1]

JP1/AJS3と連携するための設定[1]

JP1/FTPとのコネクション解放[1]

JP1/FTPとのコネクション確立[1]

JP1/FTPの環境定義[1]

JP1/IMでの伝送結果の監視[1]

JP1/IMとの連携[1]

JP1/IMと連携するための設定[1]

JP1イベント[1]

JP1プログラムとの連携機能[1]

P

PASVモードでのファイル伝送[1]

あ

アクセス制限機能での絶対パス名のルートディレクトリの変更機能[1]

アクセスログ[1]

アクセスログ採取の設定[1]

アクセスログの採取[1]

アクセスログの出力先ファイル[1]

アンインストール[1]

い

イベントビューアに表示されるメッセージ[1]

インストール[1]

インターネットプロトコルバージョンを登録する[1]

う

運用管理エージェントの起動[1]

運用管理機能[1]

運用管理コンソール画面[1]

運用管理コンソールの起動[1]

お

オンデマンド実行[1]

［オンデマンド実行］ダイアログボックス[1]

か

概要[1]

各バージョンの変更内容[1]

環境設定（ライブラリ）[1]

環境定義[1]

［環境定義］ダイアログボックス[1]

［環境定義］ダイアログボックスの設定項目[1]

［環境定義］ダイアログボックスの表示[1]

環境定義（定義ファイル）[1]

関数一覧[1]

関数の詳細[1]

関数を使用するための前提条件[1]

管理対象ホストの削除[1]

管理対象ホストの追加[1]

き

機能[1]

く

クライアント[1]

け

言語種別の設定[1]

こ

コーディング[1]

コマンド一覧[1]

コマンド実行時に表示されるメッセージ[1]

コンパイラー[1]

コンパイルとリンク[1]

さ

サーバ[1]

サービスの起動[1]

サービスの終了[1]

サービスの種類[1]

し

システム構成[1]

システム構成（JP1/AJS3と連携する）[1]

システム構成（JP1/IMと連携する）[1]

自動起動プログラム画面[1]

自動起動プログラムの削除[1]

自動起動プログラムの登録[1]

［自動起動プログラムの登録一覧］ウィンドウ[1]

［自動起動プログラムの登録一覧］ウィンドウの表示[1]

［自動起動プログラムの登録一覧］ウィンドウの表示内容の変更[1]

［自動起動プログラムの登録］ダイアログボックス[1]

［自動起動プログラムの登録］ダイアログボックスの設定項目[1]

自動起動プログラムの変更[1]

［自動起動プログラムの変更］ダイアログボックス[1]

［詳細情報］ダイアログボックス[1]

［詳細情報］ダイアログボックスの表示項目[1]

［情報のテキスト出力／テキスト追加出力］ダイアログボックス[1]

す

スケジュール伝送（JP1/AJS2）[1]

せ

接続ホスト制限機能[1]

絶対パス名の様式を登録する[1]

設定項目（［環境定義］ダイアログボックス）[1]

設定項目（［自動起動プログラムの登録］ダイアログボックス）[1]

設定項目（［伝送情報の登録］ダイアログボックス）[1]

設定項目（［表示の範囲］ダイアログボックス）[1]

設定項目（［復元する情報の選択］ダイアログボックス）[1]

設定項目（［ログインユーザの登録］ダイアログボックス）[1]

選択実行[1]

前提OS[1]

ち

注意事項[1]

注意事項（コーディング）[1]

注意事項（ライブラリの使用）[1]

て

定義情報のテキスト出力[1]

定義情報のテキスト出力（運用管理コンソール）[1]

定義情報の復元（ftsloadコマンド）[1]

定義情報の復元コマンド[1]

定義情報の復元（［定義情報の保存・復元］ダイアログボックス）[1]

定義情報の保存（ftssaveコマンド）[1]

定義情報の保存コマンド[1]

定義情報の保存（［定義情報の保存・復元］ダイアログボックス）[1]

［定義情報の保存・復元］ダイアログボックス[1]

［定義情報の保存・復元］ダイアログボックスの表示[1]

定義情報を登録する[1]

定義ユティリティ画面[1]

テキスト出力[1]

テキスト出力ファイル名[1]

テキスト追加出力[1]

伝送[1]

伝送カードの削除（ftsregcコマンド）[1]

伝送カードの削除（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送カードの内容確認（ftsregcコマンド）[1]

伝送カードの内容確認（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送カードの内容変更（ftsregcコマンド）[1]

伝送カードの内容変更（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送結果の詳細やエラーの確認[1]

伝送終了結果の取得[1]

伝送終了情報の取得[1]

伝送情報のコピー（運用管理コンソール）[1]

伝送情報の登録（ftsregcコマンド）[1]

伝送情報の登録画面[1]

［伝送情報の登録］ダイアログボックス[1]

［伝送情報の登録］ダイアログボックスの設定項目[1]

伝送情報の登録（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送情報の登録・変更・削除・表示コマンド[1]

［伝送情報の変更］ダイアログボックス[1]

伝送のオンデマンド実行（ftstranコマンド）[1]

伝送のオンデマンド実行（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送の実行コマンド[1]

伝送の選択実行（ftstranコマンド）[1]

伝送の選択実行（［伝送要求の登録／実行一覧］ウィンドウ）[1]

伝送の取り消し[1]

［伝送要求の登録／実行一覧］ウィンドウ[1]、[2]

［伝送要求の登録／実行一覧］ウィンドウの表示[1]、[2]

伝送要求の登録（同期）[1]

伝送要求の登録（非同期）[1]

と

同期実行[1]

特長[1]

トラブル時の対処[1]

トラブル発生時に採取が必要な資料[1]

ひ

引数キーワード[1]

非同期実行[1]

表示されるFTP接続応答メッセージ[1]

［表示の範囲］ダイアログボックス[1]

［表示の範囲］ダイアログボックスの設定項目[1]

ふ

ファイアウォール経由での伝送[1]

ファイアウォールの通過方向[1]

ファイルおよびディレクトリ一覧[1]

ファイル伝送機能[1]

ファイル伝送の中断[1]、[2]

ファイル伝送の流れ[1]

フォーマットファイルに指定できるキーワード[1]

フォーマットファイルの作成[1]

［復元する情報の選択］ダイアログボックス[1]、[2]

複数IPアドレス環境での使用[1]

複数ファイルの指定[1]

プログラム起動時の優先順位[1]、[2]、[3]

プロセス一覧[1]

ほ

ポート番号一覧[1]

ポート番号の設定[1]

［保存する情報の選択］ダイアログボックス[1]

め

名称解決できる環境の構築[1]

メッセージ（ftshistoryコマンド）[1]

メッセージ（ftsloadコマンド）[1]

メッセージ（ftsregcコマンド）[1]

メッセージ（ftssaveコマンド）[1]

メッセージ（ftstranコマンド）[1]

メッセージ（イベントビューア）[1]

メッセージの出力形式[1]

ゆ

［ユーザ情報の変更］ダイアログボックス[1]

［ユーザ名の指定］ダイアログボックス[1]

ら

ライブラリの使用方法[1]

ライブラリの使用例題[1]

り

［履歴情報の一覧］ウィンドウ[1]

［履歴情報の一覧］ウィンドウの表示[1]

［履歴情報の一覧］ウィンドウの表示内容の変更[1]

履歴情報の表示（運用管理コンソール）[1]

履歴情報の表示画面[1]

履歴情報の表示コマンド[1]

履歴の表示（ftshistoryコマンド）[1]

履歴ファイルの読み込み[1]

ろ

ログインユーザ情報の削除[1]

ログインユーザ情報の登録（運用管理コンソール）[1]

ログインユーザ情報の変更[1]

ログインユーザの登録[1]

［ログインユーザの登録一覧］ウィンドウ[1]

［ログインユーザの登録一覧］ウィンドウの表示[1]

ログインユーザの登録画面[1]

［ログインユーザの登録］ダイアログボックス[1]

［ログインユーザの登録］ダイアログボックスの設定項目[1]