本節では、各コマンドの文法について説明します。
なお、これらのコマンドを使用するときには環境変数を設定する必要があります。環境変数については"13.4.2 環境変数"を参照してください。
Windows 2008以降の場合、Administratorsローカルグループの権限が必要なコマンドについては、管理者としてコマンドを実行する必要があります。("管理者: コマンド プロンプト"からコマンドを実行してください。)
機能説明
TJNLの環境を新規に作成するコマンドです。
認証モードがSQL Server認証の場合、本コマンド実行時には、SQL Serverデータベースに接続するために使用するTJNLスーパバイザのユーザ名とパスワードを確認するための問合せが行われます。
入力形式
------------------------------------------------
tjnlsetup [ -s sysname ] -f filename
------------------------------------------------パラメタ
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMおよびSQL Serverを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、SQL Serverに関する詳細はSQL Serverのマニュアルを参照してください。
本コマンドを実行する前に、TJNLスーパバイザのユーザアカウントをSQL Serverに登録しておく必要があります。登録方法については、"13.4.3.3 TJNLスーパバイザの登録"を参照してください。
本コマンドを実行する前に、TJNL環境定義ファイルを作成しておく必要があります。作成方法については、"13.4.3.6 TJNLの環境作成"を参照してください。
なお、取得対象のSQL ServerのバージョンとTJNL環境定義ファイルの[DBMSInformation]セクションに指定しているSQL Serverのバージョンが不一致の場合、本コマンドが失敗します。[DBMSInformation]セクションの詳細については、"13.4.3.6 TJNLの環境作成"を参照してください。
TJNLスーパバイザのユーザ名は、SQL Serverの規約、照合順序に従ってください。
TJNLスーパバイザの登録時に、ユーザ名に[ ]で囲んだ標準識別子以外の文字を指定した場合、本コマンド実行時の応答画面で指定するユーザ名は[ ]を外した文字列を設定してください。
TJNLスーパバイザにドメインユーザを指定する場合は、SQL Serverのサービスのログイン名にドメインユーザを指定してください。
使用例
例．TJNLの環境を作成する
------------------------------------------------
tjnlsetup -f tjnldef
------------------------------------------------機能説明
TJNLの環境を削除するコマンドです。通常、ジャーナル取得ファイルに配付されていないジャーナルが存在しない場合に削除できます。配付されていないジャーナルがある場合は、-cオプションを指定して強制的に削除することもできます。
本コマンド実行時には、コマンドの実行を再確認するための問合せが行われます。
入力形式
------------------------------------------------
tjnlunsetup [ -s sysname ] [ -c ]
------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルに配付されていないジャーナルが存在しても、強制的にTJNLの環境を削除する場合に指定します。配付されていないジャーナルは消失します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMおよびSQL Serverを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、SQL Serverに関する詳細はSQL Serverのマニュアルを参照してください。
使用例
例．TJNLの環境を削除する
------------------------------------------------
tjnlunsetup
------------------------------------------------機能説明
TJNLの動作環境を変更するコマンドです。以下の値を変更することができます。
TJNLを起動する際に連動して起動する機能
UPDATE文に対するジャーナルの格納方法
配付処理のエラー発生時のリトライ方法
ジャーナル取得処理における異常時にSQL Serverから通知されるエラーメッセージ番号
ジャーナル取得対象外のプロセス名
入力形式
------------------------------------------------
tjnlcstm [ -s sysname ] -f filename
------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
TJNLの動作環境変更定義ファイルの名前を指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、TJNLの動作環境変更定義ファイルを作成しておく必要があります。作成方法については、"13.9.1.3 動作環境変更定義の記述"を参照してください。
本コマンドで変更した内容は、本コマンドの実行後のTJNL起動時に有効になります。
使用例
例．TJNLの動作環境を変更する
------------------------------------------------
tjnlcstm -f cstmdef
------------------------------------------------機能説明
ジャーナル取得ファイルのデータベーススペースにファイルを追加するコマンドです。
入力形式
------------------------------------------------
tjnlexpjdb [ -s sysname ] -f filename
------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルの追加定義ファイルの名前を指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMおよびSQL Serverを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、SQL Serverに関する詳細はSQL Serverのマニュアルを参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、ジャーナル取得ファイルの追加定義ファイルを作成しておく必要があります。作成方法については、"13.9.2.1.1 ジャーナル取得ファイルの追加定義の作成"を参照してください。
追加できるファイルの総数は、本コマンドを使用して既に追加したものも含めて5つまでです。
本コマンドで追加したファイルはTJNLの環境削除時に削除されます。
本コマンドで追加したファイルのサイズを縮小したり、削除することはできません。
使用例
例．ジャーナル取得ファイルの追加を行う
------------------------------------------------
tjnlexpjdb -f expdef
------------------------------------------------機能説明
TJNLの動作環境を表示するコマンドです。以下の情報を表示します。
各機能の運用状態
現状のTJNLの動作環境に関する情報
次回起動時に採用されるTJNLの動作環境に関する情報
ジャーナル取得ファイルに関する情報
文字コードに関する情報
連携するRDBMSに関する情報
入力形式
------------------------------------------------
tjnlstat [ -s sysname ] [ { -j | -c | -d } ]
------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルに関する情報を表示する場合に指定します。
データベースの文字コードに関する情報を表示する場合に指定します。
連携するRDBMSに関する情報を表示する場合に指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドは、SQL Serverへの接続に伴い時間が掛かる場合があります。
使用例
例1．TJNLの状態を表示する（TJNLが運用中の場合）
------------------------------------------------
tjnlstat
------------------------------------------------Status ---------------------------------------------------------- TJNL service ： ACTIVE logget ： ACTIVE logput ： INACTIVE JNLfile watch ： REQUESTED def reflect ： NOT REFLECTED Operating Environment ---------------------------------------------------------- start mode ： logget(STOP) logput(STOP) update ： DIVIDE retry ： 10(3[min]) excode ： 50001 nojnlproc ： (NONE) Operating Environment(definition file) ---------------------------------------------------------- start mode ： logget(STOP) logput(START) update ： NOT DIVIDE retry ： Unlimited(3[min]) excode ： 50002 nojnlproc ： (TRO_PROCESS) |
表示内容の説明
Status ： TJNLの運用中の情報
TJNL service ： TJNLの運用状態
logget ： ジャーナル取得機能の運用状態
logput ： ジャーナル配付機能の運用状態
運用状態は以下の形式で表示されます。
ACTIVE ： 運用中
INACTIVE ： 運用中でない
JNLfile watch ： ジャーナル配付完了通知の予約状態
ジャーナル配付完了通知の予約状態は以下の形式で表示されます。
REQUESTED ： 予約状態
NOT REQUESTED ： 予約状態でない
********* ： SQL Serverが未起動のため、状態が取得できない
def reflect ： 定義反映の状態
定義反映の状態は以下の形式で表示されます。
REFLECTING ： 取得定義または配付定義の反映が完了していない
NOT REFLECTED ： 定義反映が行われていないか、既に完了しているOperating Environment ： TJNLの動作環境情報
start mode ： ジャーナル取得機能、ジャーナル配付機能の起動種別
起動種別は以下の形式で表示されます。
logget(種別) ： ジャーナル取得機能の起動種別
logput(種別) ： ジャーナル配付機能の起動種別
START ： TJNL起動時に連動して起動する
STOP ： TJNL起動時に連動して起動しない
update ： UPDATE文に対するジャーナルの取得方法
UPDATE文に対するジャーナルの取得方法は以下の形式で表示されます。
DIVIDE ： DELETEとINSERTの情報に分割して配付する
NOT DIVIDE ： UPDATEの情報として配付する
retry ： リトライ方法
リトライ方法は以下の形式で表示されます。
n(m[min]) ： m分おきにn回リトライを行う
Unlimited(m[min]) ： m分おきに無制限にリトライを行う
0 ： リトライを行なわない
excode ： ジャーナル取得エラー時のエラーメッセージ番号
nojnlproc ： ジャーナル取得対象外のプロセス名
ジャーナル取得対象外のプロセス名は以下の形式で表示されます。
(NONE) ： すべてのプロセスからジャーナルを取得する
(TRO_PROCESS) ： 逐次差分反映のプロセスからジャーナルを取得しないOperating Environment(definition file) ： 次回起動時に有効となるTJNLの動作環境情報
本情報の表示内容は、Operating Environmentと同様です。例2．TJNLの状態を表示する（TJNLが運用中でない場合）
------------------------------------------------
tjnlstat
------------------------------------------------Status ---------------------------------------------------------- TJNL service ： INACTIVE logget ： INACTIVE logput ： INACTIVE JNLfile watch ： REQUESTED def reflect ： NOT REFLECTED Operating Environment(definition file) ---------------------------------------------------------- start mode ： logget(STOP) logput(START) update ： NOT DIVIDE retry ： Unlimited(3[min]) excode ： 50002 nojnlproc ： (TRO_PROCESS) |
表示内容の説明
"TJNLが運用中の場合"と同様です。
例3．ジャーナル取得ファイルの情報を表示する
------------------------------------------------
tjnlstat -j
------------------------------------------------Jnlfile Environment
----------------------------------------------------------
Instance ： SERVER1\DBINSTANCE
recovery model ： SIMPLE
jnlfile ： MQDJDB_TRM001
file(created) ： TJNLFILE_001 (500M)
c:\dev\tjnljdb01
TJNLFILE_002 (500M)
c:\dev\tjnljdb02
file(expanded) ： TJNLFILE_003 (500M)
c:\dev\tjnljdb03
logfile ： TJNLLOGFILE_001 (250M)
c:\tjnl\systemfile\tjnldb_log.ldf |
表示内容の説明
Jnlfile Environment ： ジャーナル取得ファイルに関する情報
Instance ： SQL Serverインスタンス名
recovery model ： 環境作成時に指定したジャーナル取得ファイルの
データベースの復旧モデル
SIMPLE：単純復旧モデル
FULL：完全復旧モデル
jnlfile ： ジャーナル取得ファイルのデータベース名
file(created) ： 環境作成時に指定したジャーナル取得ファイルの
データベーススペースに関する情報
file(expanded) ： 追加されたジャーナル取得ファイルのデータベー
ススペースに関する情報
ジャーナル取得ファイルを追加した場合に表示さ
れます。
ジャーナル取得ファイルのデータベーススペース
に関する情報は以下が表示されます。
・データベーススペース名（サイズ）
・ファイル名
logfile ： 環境作成時に指定したジャーナル取得ファイルの
データベースのトランザクションログに関する情
報ジャーナル取得ファイルのデータベースのトラ
ンザクションログに関する情報は以下が表示され
ます。
・ログファイル名(サイズ)
・ファイル名
例4．文字コードに関する情報を表示する
------------------------------------------------
tjnlstat -c
------------------------------------------------CharacterCode Environment ---------------------------------------------------------- SQL Server Database code ： SJIS |
表示内容の説明
CharacterCode Environment ： SQL Serverの文字コードに関する情報
SQL Server Database code ： SQL Serverの文字コード
SQL Serverの文字コードは以下が表示されます。
・SJIS
例5．連携するRDBMSに関する情報を表示する
------------------------------------------------
tjnlstat -d
------------------------------------------------DBMS Environment ---------------------------------------------------------- DBMS type ： SQL Server 2008 Instance ： SERVER1\DBINSTANCE Security Mode ： DB |
表示内容の説明
DBMS Environment ： 連携するRDBMSに関する情報
DBMS type ： 連携するRDBMSの種類
連携するRDBMSの種類は以下が表示されます。
・SQL Server 2008R2
・SQL Server 2012
Instance ： SQL Serverインスタンス名
Security Mode ： 連携するRDBMSの認証機構の種類
連携するRDBMSの認証機構は以下が表示されます。
・OS:OSの認証機構
・DB:SQL Serverの認証機構機能
取得定義を登録するコマンドです。以下の操作を行います。
取得定義の追加
取得定義の変更
取得定義の削除
登録された取得定義および定義反映を行った後に修正されていない取得定義を新取得定義と呼びます。新取得定義は定義反映を行うことによって、有効な定義となります。定義反映が行われた定義を、現取得定義と呼びます。
入力形式
--------------------------------------------------------------------------
tjnlfmtdef [ -s sysname ] { -a | -m | -d } { -f filename | -i }
--------------------------------------------------------------------------パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義操作を指定します。
-a : 指定された定義内容を新規に追加する
-m : 指定された定義内容で既存の定義を変更する
-d : 指定された取得定義ファイルに記述されている取得定義を削除する
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、取得定義ファイルを作成しておく必要があります。作成方法については、"13.5.4.1 取得定義の作成"を参照してください。
TJNLの環境を削除した場合、登録されていた定義はすべて削除されます。
定義操作は取得定義単位に行われます。取得定義ファイル内に複数の取得定義を記述している場合、一部の取得定義で異常が発生してもコマンドの実行は継続され、取得定義ファイルに記述されたすべての取得定義に対して定義操作が行われます。
定義内容を標準入力から入力する指定をした場合は、EOF(End of File:ファイルの終端)となるまで読込みが続けられます。通常の設定であれば、EOF文字はCTRLキー+Zを同時に押すことによって入力できます。
使用例
例．取得定義を追加する
------------------------------------------------
tjnlfmtdef -a -f fmtdef
------------------------------------------------機能
取得定義を表示するコマンドです。登録されている取得定義の内容を以下の形式で表示します。
一覧形式
定義書式形式
メッセージキューとの関連形式
現取得定義、新取得定義ともに表示できます。また、現取得定義と新取得定義の差分の表示も行えます。現取得定義および新取得定義についての詳細は"13.10.3.6 tjnlfmtdef(取得定義を登録する)"を参照してください。
複数の取得定義が存在する場合は、取得定義名を昇順に並び替えて表示します。
入力形式
--------------------------------------------------------------------------------------------------------------
tjnlprtfmtdef [ -s sysname ] { -c | -n | -m } [ -d | -q ] [ defname-1 [ defname-2 … [ defname-n ] ] ]
--------------------------------------------------------------------------------------------------------------パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義の種別を指定します。
-c : 現取得定義の内容を表示する
-n : 新取得定義の内容を表示する
-m : 現取得定義と新取得定義の差分を表示する
表示種別を指定します。本オプションを省略した場合は、取得定義名の一覧を表示します。なお、本オプションは、-cオプション、-nオプションを指定した場合にのみ指定できます。
-d : 定義書式形式で定義内容を表示する
-q : 配付定義との関連を表示する
表示の対象となる取得定義名を指定します。複数の取得定義名を指定する場合は、取得定義名を空白で区切って指定します。
本パラメタを省略した場合は、すべての取得定義が表示の対象となります。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例1．現取得定義の一覧を表示する
--------------------------------------------------------------------------
tjnlprtfmtdef -c
--------------------------------------------------------------------------現取得定義の一覧
Name ----------------------------------------------------------------- E_TOKYO HOKURIKU OSAKA W_TOKYO e_tokyo osaka |
表示内容の説明
Name ： 登録済みの取得定義名
例2．現取得定義を定義書式形式で表示する
--------------------------------------------------------------------------
tjnlprtfmtdef -c -d W_TOKYO
--------------------------------------------------------------------------定義書式形式での表示
-- DefName : W_TOKYO -- Update : 2013/01/01 11:22:33 -- User : Administrator LOGFMT "W_TOKYO" TABLE TBL001 : "家電"."関東地区"."商品マスタ" ( "商品名" : "商品名" CHAR(30) , "商品番号" : "商品番号" INT, "商品区分" : "商品区分" NUMERIC(5,0) CONV=(SIGN(OFF)) , "製造元" : "製造元" VARCHAR(MAX) CONV=(SIZE(500)) ) TABLE TBL002 : "家電"."関東地区"."売り上げ管理" ( "単価" : "単価" INT , "売り上げ額" : "売り上げ額" INT ) CHECKPOINT "DAYEND" , "WEEKEND"; |
表示内容の説明
取得定義の内容が定義形式で表示されます。なお、次の情報も注釈文として表示されます。
DefName ： 取得定義名 Update ： 最終更新日時 User ： 最終更新ユーザ名
例3．新取得定義と現取得定義の差分を表示する
--------------------------------------------------------------------------
tjnlprtfmtdef -m
--------------------------------------------------------------------------差分表示
[ADD] E_TOKYO OKINAWA [MODIFY] HOKKAIDO W_TOKYO [DELETE] KANTO SIKOKU |
表示内容の説明
[ADD] ： 定義反映を行った後、追加されている取得定義 E_TOKYO～OKINAWA ： 取得定義名 ただし、追加される取得定義が存在しない場合、当項目は表示されません。
[MODIFY] ： 定義反映を行った後、内容が変更されている取得定義 HOKKAIDO～W_TOKYO ： 取得定義名 ただし、変更される取得定義が存在しない場合、当項目は表示されません。
[DELETE] ： 定義反映を行った後、削除されている取得定義 KANTO～SIKOKU ： 取得定義名 ただし、削除される取得定義が存在しない場合、当項目は表示されません。
例4．新取得定義とメッセージキューとの関連を表示する
--------------------------------------------------------------------------
tjnlprtfmtdef -n -q
--------------------------------------------------------------------------新取得定義とメッセージキューとの関連表示
| current def
Name |-----------------------------------------------------
| new def
----------------------------------------------------------------------
E_KANAGAWA | QUE_KANAGAWA
|-----------------------------------------------------
| QUE_KANTO
| QUE_KANAGAWA
----------------------------------------------------------------------
E_NIIGATA | QUE_KANTO
|-----------------------------------------------------
| QUE_JOUETU
----------------------------------------------------------------------
e_aichi | QUE_TYUBU
|------------------------------------------------------
| QUE_TOKAI
----------------------------------------------------------------------
|
表示内容の説明
Name ： 取得定義名 current def ： 現配付定義で、取得定義と関連付けられているメッセージキュー new def ： 新配付定義で、取得定義と関連付けられているメッセージキュー なお、関連付けられているメッセージキューが存在しない場合は、空欄が表示されます。
機能
配付定義を登録するコマンドです。以下の操作を行います。
配付定義の追加
配付定義の変更
配付定義の削除
登録された配付定義および定義反映を行った後に修正されていない配付定義を新配付定義と呼びます。新配付定義は定義反映を行うことによって、有効な定義となります。定義反映が行われた定義を、現配付定義と呼びます。
入力形式
----------------------------------------------------------------------------------
tjnldef [ -s sysname ] { -a | -m | -d } -f filename
----------------------------------------------------------------------------------パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義操作を指定します。
-a : 指定された定義内容を新規に追加する
-m : 指定された定義内容で既存の定義を変更する
-d : 指定された配付定義ファイルに記述されている配付定義を削除する
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、配付定義ファイルを作成しておく必要があります。作成方法については、"13.5.5.1 配付定義の作成"を参照してください。
TJNLの環境を削除した場合、登録されていた定義はすべて削除されます。
定義操作は配付定義単位に行われます。配付定義ファイル内に複数の配付定義を記述している場合、一部の配付定義で異常が発生してもコマンドの実行は継続され、配付定義ファイルに記述されたすべての配付定義に対して定義操作が行われます。
使用例
例．配付定義を追加する
------------------------------------------------
tjnldef -a -f putdef
------------------------------------------------機能
配付定義を表示するコマンドです。登録されている配付定義の内容を以下の形式で表示します。
一覧形式
定義書式形式
現配付定義、新配付定義ともに表示できます。また、現配付定義と新配付定義の差分の表示も行えます。現配付定義および新配付定義についての詳細は"13.10.3.8 tjnldef(配付定義を登録する)"を参照してください。
複数の配付定義が存在する場合は、メッセージキュー名を昇順に並び替えて表示します。
入力形式
--------------------------------------------------------------------------------------------
tjnlprtdef [ -s sysname ] { -c | -n | -m } [ -d ] [ quename-1 [ quename-2 … [ quename-n ] ] ]
--------------------------------------------------------------------------------------------パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義の種別を指定します。
-c : 現配付定義の内容を表示する
-n : 新配付定義の内容を表示する
-m : 現配付定義と新配付定義の差分を表示する
定義書式形式で表示する場合に指定します。本オプションを省略した場合は、配付定義で定義されているメッセージキュー名の一覧を表示します。なお、本オプションは、-cオプション、-nオプションを指定した場合にのみ指定できます。
表示の対象となるメッセージキュー名を指定します。複数のメッセージキュー名を指定する場合は、メッセージキュー名を空白で区切って指定します。
本パラメタを省略した場合は、すべてのメッセージキューが表示の対象となります。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例1．現配付定義の一覧を表示する
---------------------------------
tjnlprtdef -c
---------------------------------図:現配付定義の一覧
Queue Logfmt --------------------------------------------------------------- QUE001 W_TOKYO QUE002 E_TOKYO QUE003 OKINAWA |
表示内容の説明
Queue ： メッセージキュー名 Logfmt ： メッセージキューと関連付けられている取得定義名
例2．現配付定義を定義書式形式で表示する
---------------------------------
tjnlprtdef -c -d
---------------------------------図:定義書式形式での表示
# Queue : QUE010 # Update : 2013/01/01 11:22:33 # User : Administrator [Queue] Name = QUE010 Logfmt = W_TOKYO Compress = COMP Pack = PACK MsgLen = 30K Attr = ADD CharInfo = EXTEND TimeInfo = STRING OutCode = GS_KANA UndefCtrl = CHANGE2 # Queue : QUE011 # Update : 2013/01/01 11:22:33 # User : Administrator [Queue] Name = QUE011 Logfmt = NIIGATA Compress = COMP Pack = PACK MsgLen = 30K Attr = ADD CharInfo = EXTEND TimeInfo = STRING OutCode = GS_KANA UndefCtrl = CHANGE1 # Queue : QUE012 # Update : 2013/01/01 11:22:33 # User : Administrator [Queue] Name = QUE012 Logfmt = TOUHOKU Compress = NOCOMP Pack = PACK MsgLen = 2M Attr = NOADD TimeInfo = STRING OutCode = NOCNV |
表示内容の説明
配付定義の内容が定義形式で表示されます。なお、次の情報も注釈文として表示されます。
Queue ： メッセージキュー名 Update ： 最終更新日時 User ： 最終更新ユーザ名
例3．新配付定義と現配付定義の差分を表示する
---------------------------------
tjnlprtdef -m
---------------------------------図:差分表示
[ADD] QUE010 QUE011 [MODIFY] QUE001 QUE002 [DELETE] QUE100 QUE200 |
表示内容の説明
[ADD] ： 定義反映を行った後、追加されている配付定義 QUE010～QUE011 ： 配付定義名（メッセージキュー名） ただし、追加される配付定義が存在しない場合、当項目は表示されません。
[MODIFY] ： 定義反映を行った後、内容が変更されている配付定義 QUE001～QUE002 ： 配付定義名（メッセージキュー名） ただし、変更される配付定義が存在しない場合、当項目は表示されません。
[DELETE] ： 定義反映を行った後、削除されている配付定義 QUE100～QUE200 ： 配付定義名（メッセージキュー名） ただし、削除される配付定義が存在しない場合、当項目は表示されません。
機能
TJNLを起動するコマンドです。
入力形式
----------------------------------------------
trmqdstrsvc [ -s sysname ] [ -n ] svcname
----------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
未反映の定義を反映してからTJNLを起動する場合に指定します。
サービス名として"tjnl"または"TJNL"を指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMおよびSQL Serverを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、SQL Serverに関する詳細はSQL Serverのマニュアルを参照してください。
使用例
例．定義を反映してTJNLを起動する
----------------------------------------------
trmqdstrsvc -n TJNL
----------------------------------------------機能
TJNLを停止するコマンドです。
入力形式
----------------------------------------------
trmqdstpsvc [ -s sysname ] svcname
----------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
サービス名として"tjnl"または"TJNL"を指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、すべてのアプリケーションプログラム(SQL Server Management Studioなどを含みます)を、環境作成時にTJNL環境定義ファイルで指定したSQL Serverデータベースから切断しておいてください。
使用例
例．TJNLを停止する
----------------------------------------------
trmqdstpsvc TJNL
----------------------------------------------機能
TJNLの一部機能であるジャーナル取得機能、ジャーナル配付機能を起動するコマンドです。
入力形式
----------------------------------------------
tjnlstr [ -s sysname ] { -g | -p [ -n ] }
----------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
起動する機能を指定します。
-g : ジャーナル取得機能
-p : ジャーナル配付機能
未反映の配付定義を反映してからジャーナル配付機能を起動する場合に指定します。なお、本オプションは、-pオプションと同時に指定してください。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを使用してジャーナル取得機能またはジャーナル配付機能を起動するには、TJNLが運用中である必要があります。
使用例
例1．ジャーナル取得機能を起動する
----------------------------------------------
tjnlstr -g
----------------------------------------------例2．ジャーナル配付機能を定義反映モードで起動する
----------------------------------------------
tjnlstr -p -n
----------------------------------------------機能
TJNLの一部機能であるジャーナル取得機能、ジャーナル配付機能を停止するコマンドです。
ジャーナル取得機能は、-cオプションを指定して強制的に停止することもできます。
入力形式
----------------------------------------------
tjnlstp [ -s sysname ] { -g [-c] | -p }
----------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
停止する機能を指定します。
-g : ジャーナル取得機能
-p : ジャーナル配付機能
SQL Serverデータベースに接続中のアプリケーションが存在した状態でも、強制的にジャーナル取得機能を停止します。ジャーナル取得機能の停止時に既にトランザクションを開始していた場合は、そのトランザクションの終了時にジャーナルを取得します。なお、本オプションは、-gオプションと同時に指定してください。本オプションを省略した場合は、通常停止します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドによりジャーナル取得機能を通常停止する前に、すべてのアプリケーションプログラム(SQL Server Management Studioなどを含みます)を、環境作成時にTJNL環境定義ファイルで指定したSQL Serverデータベースから切断しておいてください。
使用例
例1．ジャーナル取得機能を停止する
----------------------------------------------
tjnlstp -g
----------------------------------------------例2．ジャーナル配付機能を停止する
----------------------------------------------
tjnlstp -p
----------------------------------------------機能
ジャーナル・チェックポイントを取得するコマンドです。本コマンドの実行により、ジャーナル・チェックポイントの情報がジャーナル取得ファイルに取得されます。
なお、ジャーナル・チェックポイントはジャーナル配付機能が運用状態のときにメッセージキューへ配付されます。ジャーナル・チェックポイントが配付された時点で、配付された旨を通知するメッセージをイベントログに表示します。
入力形式
----------------------------------------------
tjnlckpt [ -s sysname ] -k ckptname
----------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
業務の区切りとして取得するジャーナル・チェックポイントの名前を、32byte以内の文字列で指定します。使用可能な文字は、英数字、"@"、"_"です。なお、本コマンドを実行する前に、取得定義によりジャーナル・チェックポイント名を定義しておく必要があります。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRM、SQL Server、TJNLおよびジャーナル取得機能を起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、SQL Serverに関する詳細はSQL Serverのマニュアルを参照してください。また、TJNLの起動は"13.10.3.10 trmqdstrsvc(TJNLを起動する)"を、ジャーナル取得機能の起動は"13.10.3.12 tjnlstr(TJNLの一部の機能を起動する)"を参照してください。
配付定義のOutCodeキーワードにGS_KANAを指定した場合は、ジャーナル・チェックポイントの名前には英小文字を使用しないでください。
使用例
例．ジャーナル・チェックポイント"JNL_END"を取得する
----------------------------------------------
tjnlckpt -k JNL_END
----------------------------------------------機能
利用ジャーナルをメッセージキューより取り出し、一般ファイルに格納するコマンドです。
メッセージ取出し途中にシステムダウンなどの異常が発生した場合に備えて、データを一時的に以下の名前のファイルに格納します。
{指定されたファイル名}.{TRMシステム名}MQDMQD |
コマンドが1回の操作で取り出すデータを取り出し終えた時点で、指定されたファイル名に変更します。
入力形式
-------------------------------------------------------------
tjnlgetmsg [ -s sysname ] -f filename [ -j ] qname
-------------------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
利用ジャーナルを格納するファイル名を指定します。
ファイルを上書きするかの問合せを回避する場合に指定します。
利用ジャーナルを取り出すメッセージキュー名を指定します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドは、多重で実行できません。
本コマンドではシステム内で取得した利用ジャーナルのメッセージのみ扱えます。JournalTransferを使用して転送された利用ジャーナルのメッセージは扱えません。
1つのメッセージキューに対して、本コマンドの実行と以下の処理を同時に行わないでください。利用ジャーナルが正しく取り出せないことがあります。
JournalTransferによるメッセージの送信
TRMのコマンドによるメッセージの削除
作成されるファイルのアクセス権は、コマンド実行者が新規に作成したファイルのアクセス権になります。
本コマンドの実行中にシステムダウンなどの異常が発生した場合は、以下の点に注意してください。
指定したファイル名のファイルが作成されていない場合は、メッセージ取出しが完了していません。再度本コマンドを実行してください。
指定されたファイル名のファイルが作成されている場合でも、取り出したメッセージがメッセージキューから削除されていないことがあるため、別の名前を指定して本コマンドを実行した後、前回の実行時に作成されたファイルとデータの内容を比較してください。
今回の実行時に作成されたファイルに、前回の実行時に作成されたファイルと同じ内容のデータが含まれる場合には、今回の実行時に作成されたファイルを使用し、前回の実行時に作成されたファイルは破棄してください。
上記以外の場合は、両方のファイルを使用してください。
使用例
例．メッセージキュー"QUE001"より利用ジャーナルを取り出す
----------------------------------------------
tjnlgetmsg -f outfile QUE001
----------------------------------------------メッセージ取出しコマンドの表示例
first data time ： 2013/01/01 15:35:28 last data time ： 2013/01/01 15:50:33 number of message ： 1900 file size ： 3333 end type ： CheckPoint[jnl_end] |
表示内容の説明
first data time ： 最初の利用ジャーナルの取得時間（年/月/日 時:分:秒）
last data time ： 最後の利用ジャーナルの取得時間（年/月/日 時:分:秒）
number of message ： 利用ジャーナル取出し件数
ただし、利用ジャーナルを取り出せない場合は"0"となります
file size ： 出力ファイルのサイズ (単位：byte)
end type ： メッセージ取出しの終了タイプ
メッセージ取出しの終了タイプは以下の形式で表示されます。
LogMessageGetMAX ： 取出し件数もしくは取出しサイズの最大値に到達した
NotEndTranLogMessage ： トランザクションが完結していない
NoMoreLogMessage ： すべての利用ジャーナルの取出し完了
NotLogMessage ： 利用ジャーナル以外のメッセージを検出した
CheckPoint ： ジャーナル・チェックポイントを検出した
※ジャーナル・チェックポイント検出時のみ後ろにジャーナル・チェックポイント名が出力されます機能
ジャーナル取得ファイルに未配付のジャーナルが存在するか否かを通知するコマンドです。
入力形式
-------------------------------------------------------------
tjnlinfle [ -s sysname ] [ -w | -p ]
-------------------------------------------------------------パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル配付完了通知の予約の有無を指定します。本パラメタを省略した場合、ジャーナル取得ファイルに未配付のジャーナルが存在するか否かを通知します。
-w :ジャーナル取得ファイルに未配付のジャーナルが存在する場合、ジャーナル配付完了通知を予約します。ジャーナル取得ファイルに未配付のジャーナルがなくなった時点で、その旨を通知するTJNL5917メッセージをイベントログに表示します。
-p : ジャーナル配付完了通知の予約が行われている場合、その予約を取消します。
注意事項
本コマンドは、Administratorsローカルグループのユーザだけが実行できます。
本コマンドを実行する前に、TRMおよびSQL Serverを起動しておく必要があります。TRMの起動に関する詳細は"第4部 TRM"を、SQL Serverの起動に関する詳細は、SQL Serverのマニュアルを参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例1．ジャーナル取得ファイルに未配付のジャーナルが存在するか否かを通知する
-------------------------------------------------------------
tjnlinfle
-------------------------------------------------------------例2．ジャーナル配付完了通知を予約する
-------------------------------------------------------------
tjnlinfle -w
-------------------------------------------------------------例3．ジャーナル配付完了通知の予約を取り消す
-------------------------------------------------------------
tjnlinfle -p
-------------------------------------------------------------