[Windows]

fteModifyLogger(「MFTロガーを「Windowsサービスとして実行)

Managed File Transfer ロガーを Windows サービスとして実行できるように変更するには、 fteModifyLogger コマンドを使用します。 このコマンドは Windows プラットフォームでのみ使用でき、 IBM® MQ 管理者で mqm グループのメンバーであるユーザーによって実行されなければならない。 で、最初に fteStopLogger コマンドを使用してロガーを停止する必要があります。

目的

スタンドアロン・ロガーは、ファイルの場合もデータベースの場合も、サービス アプリケーションの 名前列にプロパティー・セット logger_name@logger_qmManaged File Transferロガーと表示されます。 logger_qm の値は、ロガーのコマンド・キュー・マネージャーの名前です。

Syntax

fteModifyLogger

Read syntax diagramSkip visual syntax diagramfteModifyLogger-loggerName logger_name -p configuration_ options-n-s service_nameWindows systems options
Windows system options
Read syntax diagramSkip visual syntax diagram-su user_name -sp password-sj options-sl options

パラメーター

--loggerName logger_name
必須。 変更しようとしている Managed File Transfer ロガーの名前。
-p configuration_options
オプション。 このパラメーターは、ロガーを変更するために使用される構成オプションのセットを決定します。 慣例として、このパラメーターの入力には、デフォルト調整キュー・マネージャー以外の名前を使用します。 これで、fteModifyLogger コマンドは、デフォルト以外の調整キュー・マネージャーと関連付けられたプロパティー・ファイルのセットを使用します。
オプションの-pパラメーターは、デフォルト以外の構成オプションを使用する場合にのみ指定してください。 このパラメーターを指定しない場合、デフォルトの調整キュー・マネージャーに基づいた構成オプションのセットが使用されます。
-サービス名
オプション。 ロガーを Windows サービスとして実行するように指示します。 service_name を指定しない場合、サービスの名前はmqmftLoggerLOGGERQMGRになります。ここで、LOGGER はロガー名、QMGR はロガー・キュー・マネージャー名です。
Windows サービス 」ウィンドウの 「名前」 列に表示されるサービスの表示名は、常に Managed File Transfer Logger LOGGER@QMGRです。
-su ユーザー名
-sが指定されている場合は必須です。 Windows サービスを実行するアカウント名を指定します。 Windowsドメイン・ユーザー・アカウントを使用してエージェントを実行するには、DomainName\UserNameの形式で値を指定します。 ローカル組み込みドメインのアカウントを使用してサービスを実行するには、UserNameの形式で値を指定します。
-suパラメーターを使用して指定するWindowsユーザー・アカウントには、サービスとしてログオンする権限が必要です。 この権限を付与する方法については、 MFT エージェントまたはロガーを Windows サービスとして実行するためのガイダンスを参照してください。
-sp パスワード
オプション。 -sが指定されている場合にのみ有効です。 -suパラメーターによって設定されたユーザー・アカウントのパスワード。
-sパラメーターを指定するときにこのパラメーターを指定しないと、サービスを正常に開始するには Windowsサービス・ツールを使用してパスワードを設定する必要があるという警告が出されます。
-sj オプション
オプション。 -sが指定されている場合にのみ有効です。 ロガーが「Windowsサービスとして開始されるとき、このパラメータは、JVMに渡される-Dまたは-Xの形式のオプションのリストを定義する。 オプションは、番号記号 (#) またはセミコロン (;) 文字を使用して区切られます。 # または ; 文字を組み込む必要がある場合は、それらを単一引用符 (') で囲みます。
fteModifyLogger コマンドがJVMオプションの更新の検証を処理する方法の詳細については、「 エージェントまたはロガーのJVMオプションを更新するためのガイダンス 」を参照してください。
-sl オプション
オプション。 -sが指定されている場合にのみ有効です。 Windows サービスのログ・レベルを設定します。 有効なオプションは、 error infowarndebugです。 デフォルトは infoです。 このオプションは、Windows サービスに関して問題が発生した場合に便利です。 これを debug に設定すると、より詳細な情報がサービス・ログ・ファイルに記録されます。
-n
オプション。 ロガーを通常のプロセスとして実行するように指示します。 これは、-sオプションと同時に指定することはできません。 -sオプションも-nオプションも指定しない場合、ロガーは通常のWindowsプロセスとして構成されます。
- ? または -h
オプション。 コマンド構文を表示します。

fteModifyLoggerコマンドを実行する前に、fteStopLoggerコマンドを使用してロガーを停止する必要があります。

この例では、logger1 というロガーが以前に作成されています。 次のコマンドは、Windows サービスとして実行されるようにロガーを変更する方法を示しています。
fteModifyLogger -loggerName logger1 -s -su fteuser -sp ftepassword

戻りコード

0
コマンドは正常に完了しました。
1
コマンドは失敗しました。