fteCreateLogger(「MFTファイルまたはデータベースのロガーを作成する)

IBM i のロガー

Managed File Transfer ロガーは、 IBM i プラットフォームではサポートされません。

目的

これらのキューは、内部システム・キューであるため、ロガーを削除しない限り、メッセージの変更、削除、または読み取りを行うことはできません。 実行する MQSC コマンドは、MQ_DATA_PATH\mqft\config\coordination_qmgr\loggers\logger_name\logger_name_create.mqsc にあるファイルでも提供されます。

後でロガーを削除したい場合は、 fteDeleteLogger コマンドを使用します。

Managed File Transfer には、ロガーの構成に役立つ拡張ロガー・プロパティーが用意されています。 MFT ロガーの構成プロパティー を参照してください。

特殊文字

特殊文字が含まれているパラメーター値を使用する場合には、予期しない形で特殊文字がコマンド・シェルで解釈されないように注意してください。 例えば、スペース、引用符 (単一または二重)、スラッシュ、バックスラッシュ文字などを含む完全修飾ファイル・パスや名前は、直接コマンド自体に渡されずに、コマンド・シェルで解釈されてしまう可能性があります。 文字がコマンド・シェルによって解釈される動作を回避するには、パラメーター全体を二重/単一引用符で囲むか、またはコマンド・シェルのエスケープ・シーケンスを使用して特殊文字をエスケープします。

構文

fteCreateLogger

DATABASE options

FILE options

Windows システム・オプション

Parameters for MQ security

パラメーター

--loggerTypeタイプ

必須。 どこにファイル転送管理情報が記録されるかを指定します。 オプションのタイプは、転送情報をデータベースに記録する場合は DATABASE、情報をファイルに記録する場合は FILE のいずれかです。

--loggerQMgr(qmgr_name)

オプション。 ファイル転送管理の情報が含まれるメッセージを受け取るために接続するキュー・マネージャーを指定します。 キュー・マネージャーはロガーと同じシステム上になければなりません。 -loggerQMgrパラメーターを指定しない場合、このロガーの構成オプション・セットに関連付けられた調整キュー・マネージャーがデフォルトとして使用されます。

IBM MQ 9.1以降、調整キュー・マネージャーがクライアント・モード接続を使用して接続する場合、ロガーはクライアント・モードを使用します。

重要: loggerQmgrHost、 loggerQmgrPort、および loggerQmgrChannel パラメーターは、ファイル・ロガーでのみ有効です。

これらのパラメーターのいずれか 1 つまたは複数をデータベース・ロガーで使用しようとすると、以下のメッセージを受け取ります。

BFGCL0456E: The parameter '-loggerQMgrHost' is not valid for the fteCreateLogger command.

--dbType(データベース型)

-loggerTypeが DATABASEの場合は必須。 ファイル転送管理情報の格納に使用するデータベース管理システムのタイプを指定します。 オプションは db2 または oracle です

注: SQL ファイルを使用して表を作成する必要があります。 .sql ファイルは MQ_INSTALLATION_PATH_/mqft/sql から入手できます。

• Db2 データベースの場合 : ftelog_tables_db2.sql
• Oracle データベースの場合 : ftelog_tables_oracle.sql

--dbName(データベース名)

-loggerTypeが DATABASEの場合は必須。 ファイル転送管理情報が格納されるデータベースの名前。 データベースは、 Managed File Transfer ログ表を使用して構成する必要があります。

--dbDriverドライバー

-loggerTypeが DATABASEの場合は必須。 データベースの JDBC ドライバー・クラスの場所。 これは通常、JAR ファイルのパスおよびファイル名です。

--dbLib(パス)

-loggerTypeが DATABASEの場合はオプション。 選択したデータベース・ドライバーが必要とするネイティブ・ライブラリーの場所。

-ファイルロガーモード

-loggerTypeが FILEである場合に必要です。 ファイル転送管理情報の格納に使用するファイル・システムのタイプを指定します。 オプションは LINEAR または CIRCULAR です。

オプション LINEAR は、ファイルが -filesize で定義されている最大サイズに到達するまで、ファイル・ロガーがそのファイルに情報を書き込むことを意味します。 最大サイズに達すると、ファイル・ロガーは新しいファイルに移ります。 以前に書き込まれたファイルは削除されないため、それらをログ・メッセージの履歴レコードとして保持できます。 このモードで実行している場合、ファイルは削除されず、作成可能なファイル数の上限もないため、-fileCount は無視されます。 このモードで実行している場合には上限がないため、ディスク・スペースが少なくならないように、ログ・ファイルによって使用されているディスク・スペースの量を追跡する必要があります。

オプション CIRCULAR は、ファイルが -fileSize で定義されている最大サイズに到達するまで、ファイル・ロガーがそのファイルに情報を書き込むことを意味します。 最大サイズに達すると、ファイル・ロガーは新しいファイルに移ります。 このモードで書き込まれるファイルの最大数は、-fileCount を使用して定義される値によって制御されます。 このファイル最大数に到達すると、ファイル・ロガーは最初のファイルを削除して再作成し、それを現行のアクティブ・ファイルとして使用します。 -fileSize で定義された値が固定サイズ・バイト単位である場合、このモードで使用されるディスク・スペースの上限は、fileSize x fileCount に等しくなります。 -fileSize で定義された値が時間単位である場合、最大サイズは、ご使用のシステムにおけるその時間内のログ・メッセージのスループットによって決まります。

詳しくは、 MFT ロガーの構成プロパティー を参照してください。

-ファイルサイズ

-loggerTypeが FILEである場合に必要です。 ログ・ファイルが大きくなることが許可される最大サイズ。 値は、ゼロより大きい正整数で、単位 KB、MB、GB、m (分)、h (時)、d (日)、w (週) のいずれか 1 つを後に付けます。 例えば、-fileSize 5MB (最大サイズを 5MB に指定)、-fileSize 2d (最大 2 日分のデータを指定) です。

--fileCount数

-loggerTypeが FILEで、-fileLoggerModeが CIRCULARの場合に必要です。 作成するログ・ファイルの最大数。 データ量が、このファイル数で保管できる最大量を超えた場合、最も古いファイルが削除されるので、ログ・ファイルの数はこのパラメーターで指定される値を超えることはありません。

-loggerQMgrHost

ロガー・キュー・マネージャーが実行されているマシンのホスト名または IP アドレス。

デフォルト値は none です。

-loggerQMgrHostパラメーターを指定しない場合、ロガーはバインディング・モードで作成されます。

-loggerQMgrPort

ロガー・キュー・マネージャーが listen するポート番号。

デフォルト値は 1414 です。

-loggerQMgrChannel

ロガー・キュー・マネージャーへの接続に使用されるチャネルの名前。

デフォルト値は SYSTEM.DEF.SVRCONN です。

-s (service_name )

オプション (Windows システムのみ)。 ロガーを Windows サービスとして実行するように指示します。 サービス名を指定しない場合、サービスの名前はmqmftLoggerLOGGERQMGRになります。ここで、LOGGER はロガー名、QMGR はロガー・キュー・マネージャー名です。

「 Windows サービス 」ウィンドウの 「名前」 列に表示されるサービスの表示名は、常に Managed File Transfer Logger LOGGER@QMGRです。

-su (ユーザー名 )

オプション (Windows のみ)。 ロガーが Windows サービスとして実行される場合、このパラメーターは、サービスが実行されるアカウントの名前を指定しま す。 Windowsドメイン・ユーザー・アカウントを使用してロガーを実行するには、DomainName\UserNameの形式で値を指定します。 ローカル組み込みドメインのアカウントを使用してサービスを実行するには、UserNameの形式で値を指定します。

-suパラメーターを使用して指定するWindowsユーザー・アカウントには、Log on as a service権限が必要です。 この権限を付与する方法については、 MFT エージェントまたはロガーを Windows サービスとして実行するためのガイダンスを参照してください。

-sが指定されている場合は必須です。

-sp (パスワード )

オプション (Windows のみ)。 -suパラメーターによって設定されたユーザー・アカウントのパスワード。

このパラメーターは、-sが指定されている場合にのみ有効です。 -sパラメーターを指定するときにこのパラメーターを指定しないと、警告メッセージが生成されます。 このメッセージは、サービスを正常に開始するには、Windows サービス・ツールを使用してパスワードを設定する必要があることを警告します。

-sj (オプション )

オプション (Windows のみ)。 ロガーが Windows サービスとして開始される場合は、JVM に渡されるオプションのリストを -D または -X の形式で定義します。 オプションは、番号記号 (#) またはセミコロン (;) 文字を使用して区切られます。 (#) またはセミコロン (;) 文字を組み込む必要がある場合は、それらを単一引用符で囲みます。

このパラメーターは、-sが指定されている場合にのみ有効です。

-sl (オプション )

オプション (Windows のみ)。 Windows サービスのログ・レベルを設定します。 有効なオプションは、 error、 info、 warn、 debugです。 デフォルトは info です。 このオプションは、Windows サービスに関して問題が発生した場合に便利です。 これを debug に設定すると、より詳細な情報がサービス・ログ・ファイルに記録されます。

このパラメーターは、-sが指定されている場合にのみ有効です。

--p（設定オプション）

オプション。 ロガーの作成に使用する構成オプションのセットを指定します。 慣例として、この値は調整キュー・マネージャーの名前です。 このパラメーターを指定しない場合、デフォルトの構成オプションのセットが使用されます。

-f

オプション。 コマンドに強制的に既存の構成を上書きさせます。

(logger_name)

必須。 作成するロガーの名前。 これは Managed File Transfer キュー名に取り込まれるので、文字、数字、およびピリオド (.) と下線文字 (_) のみが含まれるようにする必要があります。 また、長さが最大 28 文字までに制限されています。

-credentialsFile (filePath)

オプション。 IBM MQ 認証の詳細が追加される既存または新規の資格情報ファイルの絶対ファイル・パス。

このコマンドは、指定されたManaged File Transfer資格情報ファイルへの一連のIBM MQ認証詳細の追加をサポートします。 このコマンドは、 IBM MQ 接続認証が有効になっている場合に使用します。 既存の詳細を更新する場合は、-fforce パラメーターを使用する必要があります。

-userid (ユーザー名)

オプション。 資格情報の詳細を関連付けるために使用するユーザー ID。 ユーザー ID を指定しない場合、資格情報の詳細はすべてのユーザーに適用されます。 -credentialsFileパラメーターも指定する必要があります。

- ? または -h

オプション。 コマンド構文を表示します。

戻りコード

0

コマンドは正常に完了しました。

1

コマンドは失敗しました。