本節では、各コマンドの文法について説明します。
なお、これらのコマンドを使用するときには環境変数を設定する必要があります。環境変数については"11.3.2 環境変数"を参照してください。
Windows 2008以降の場合、Administratorsローカルグループの権限が必要なコマンドについては、管理者としてコマンドを実行する必要があります。("管理者: コマンド プロンプト"からコマンドを実行してください。)
機能説明
TJNLの環境を新規に作成するコマンドです。
入力形式
------------------------------------------------ tjnlsetup [ -s sysname ] -f filename ------------------------------------------------
パラメタ
注意事項
本コマンドは、スーパユーザの資格を持つ利用者(WindowsではAdministratorsローカルグループのユーザ)だけが実行できます。
本コマンドを実行する前に、TRMおよびSymfoware/RDBを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、Symfoware/RDBに関する詳細はSymfowareのマニュアルを参照してください。
本コマンドを実行する前に、TJNL環境定義ファイルを作成しておく必要があります。作成方法については、"11.3.3.5 TJNL環境定義の作成"を参照してください。
使用例
例.TJNLの環境を作成する
------------------------------------------------ tjnlsetup -f tjnldef ------------------------------------------------
機能説明
TJNLの環境を削除するコマンドです。通常、ジャーナル取得ファイルに配付されていないジャーナルが存在しない場合に削除できます。配付されていないジャーナルがある場合は、-cオプションを指定して強制的に削除することもできます。
本コマンド実行時には、コマンドの実行を再確認するための問合せが行われます。
入力形式
------------------------------------------------
tjnlunsetup [ -s sysname ] [ -c ]
------------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルに配付されていないジャーナルが存在しても、強制的にTJNLの環境を削除する場合に指定します。配付されていないジャーナルは消失します。
注意事項
本コマンドは、スーパユーザの資格を持つ利用者(WindowsではAdministratorsローカルグループのユーザ)だけが実行できます。
本コマンドを実行する前に、TRMおよびSymfoware/RDBを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、Symfoware/RDBに関する詳細はSymfowareのマニュアルを参照してください。
強制削除では、エラーが発生しても処理を継続します。そのため、ジャーナル取得ファイルとして作成したデータベースが削除されずに残ることがあります。その場合は、Symfoware/RDBのコマンドを使用してジャーナル取得ファイルとして作成したデータベースを削除してください。ジャーナル取得ファイルのデータベース名についての詳細は、TJNL環境定義ファイルの"11.3.4.4 記述内容の説明"を参照してください。
使用例
例.TJNLの環境を削除する
------------------------------------------------ tjnlunsetup ------------------------------------------------
機能説明
TJNLの動作環境を変更するコマンドです。以下の値を変更することができます。
TJNLを起動する際に連動して起動する機能
1トランザクションあたりの最大ジャーナル格納域サイズ
UPDATE文に対するジャーナルの格納方法
配付処理のエラー発生時のリトライ方法
入力形式
------------------------------------------------ tjnlcstm [ -s sysname ] -f filename ------------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
TJNLの動作環境変更定義ファイルの名前を指定します。
注意事項
本コマンドは、スーパユーザの資格を持つ利用者(WindowsではAdministratorsローカルグループのユーザ)だけが実行できます。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、TJNLの動作環境変更定義ファイルを作成しておく必要があります。作成方法については、"11.8.1.3 動作環境変更定義の記述"を参照してください。
本コマンドで変更した内容は、本コマンドの実行後のTJNL起動時に有効になります。
使用例
例.TJNLの動作環境を変更する
------------------------------------------------ tjnlcstm -f cstmdef ------------------------------------------------
機能説明
ジャーナル取得ファイルにデータベーススペースを追加するコマンドです。
入力形式
------------------------------------------------ tjnlexpjdb [ -s sysname ] -f filename ------------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルの追加定義ファイルの名前を指定します。
注意事項
本コマンドは、スーパユーザの資格を持つ利用者(WindowsではAdministratorsローカルグループのユーザ)だけが実行できます。
本コマンドを実行する前に、TRMおよびSymfoware/RDBを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、Symfoware/RDBに関する詳細はSymfowareのマニュアルを参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、ジャーナル取得ファイルの追加定義ファイルを作成しておく必要があります。作成方法については、"11.8.2.1.1 ジャーナル取得ファイルの追加定義の作成"を参照してください。
本コマンドで追加したデータベーススペースは、TJNLの環境削除時に削除されます。また、一度追加したファイルのサイズを縮小したり、削除することはできません。
本コマンドを投入後、ジャーナル取得ファイルの容量が枯渇した時点で、ジャーナル取得ファイルの領域が拡張されます。
追加できるデータベーススペースの総数は、本コマンドを使用して既に追加したものも含めて5つまでです。
使用例
例.ジャーナル取得ファイルの追加を行う
------------------------------------------------ tjnlexpjdb -f expdef ------------------------------------------------
機能説明
TJNLの動作環境を表示するコマンドです。以下の情報を表示します。
各機能の運用状態
現状のTJNLの動作環境に関する情報
次回起動時に採用されるTJNLの動作環境に関する情報
ジャーナル取得ファイルに関する情報
文字コードに関する情報
入力形式
------------------------------------------------
tjnlstat [ -s sysname ] [ { -j | -c } ]
------------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
ジャーナル取得ファイルに関する情報を表示する場合に指定します。
以下の文字コードに関する情報を表示する場合に指定します。
OS
データベース
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例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) buffer size : 2000K update : DIVIDE retry : 10(3[min]) Operating Environment(definition file) ---------------------------------------------------------- start mode : logget(STOP) logput(START) buffer size : 3000K update : NOT DIVIDE retry : Unlimited(3[min]) |
表示内容の説明
Status : TJNLの運用中の情報 TJNL service : TJNLの運用状態 logget : ジャーナル取得機能の運用状態 logput : ジャーナル配付機能の運用状態 運用状態は以下の形式で表示されます。 ACTIVE : 運用中 INACTIVE : 運用中でない JNLfile watch : ジャーナル配付完了通知の予約状態 ジャーナル配付完了通知の予約状態は以下の形式で表示されます。 REQUESTED : 予約状態 NOT REQUESTED : 予約状態でない ********* : Symfoware/RDBが未起動のため、状態が取得できない def reflect : 定義反映の状態 定義反映の状態は以下の形式で表示されます。 REFLECTING : 取得定義または配付定義の反映が完了していない NOT REFLECTED : 定義反映が行われていないか、既に完了している
Operating Environment : TJNLの動作環境情報 start mode : ジャーナル取得機能、ジャーナル配付機能の起動種別 起動種別は以下の形式で表示されます。 logget(種別) : ジャーナル取得機能の起動種別 logput(種別) : ジャーナル配付機能の起動種別 START : TJNL起動時に連動して起動する STOP : TJNL起動時に連動して起動しない buffer size : 1トランザクションあたりの最大ジャーナル格納域サイズ update : UPDATE文に対するジャーナルの取得方法 UPDATE文に対するジャーナルの取得方法は以下の形式で表示されます。 DIVIDE : DELETEとINSERTの情報に分割して配付する NOT DIVIDE : UPDATEの情報として配付する retry : リトライ方法 リトライ方法は以下の形式で表示されます。 n(m[min]) : m分おきにn回リトライを行う Unlimited(m[min]) : m分おきに無制限にリトライを行う 0 : リトライを行なわない
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) buffer size : 3000K update : NOT DIVIDE retry : Unlimited(3[min]) |
表示内容の説明
"TJNLが運用中の場合"と同様です。
例3.ジャーナル取得ファイルの情報を表示する
------------------------------------------------ tjnlstat -j ------------------------------------------------
Jnlfile Environment ---------------------------------------------------------- RDBsystem : <default> jnlfile : TRMJDB_TRM001 dsi : JNLGETDSI dbspace(created) : jnldbsp01 (500M) /dev/rdsk/c0t0d0s1 jnldbsp02 (500M) /dev/rdsk/c0t0d0s2 dbspace(expanded) : jnldbsp03 (500M) /dev/rdsk/c0t0d0s3 |
Jnlfile Environment ---------------------------------------------------------- RDBsystem : <default> jnlfile : TRMJDB_TRM001 dsi : JNLGETDSI dbspace(created) : jnldbsp01 (500M) c:\dev\tjnljdb01 jnldbsp02 (500M) c:\dev\tjnljdb02 dbspace(expanded) : jnldbsp03 (500M) c:\dev\tjnljdb03 |
表示内容の説明
Jnlfile Environment : ジャーナル取得ファイルに関する情報 RDBsystem : Symfoware/RDBのシステムの名前 jnlfile : ジャーナル取得ファイルの名前 dsi : ジャーナル取得ファイルのDSIの名前 dbspace(created) : 環境作成時に作成したジャーナル取得ファイルのデータベーススペースに関する情報 dbspace(expanded) : 追加されたジャーナル取得ファイルのデータベーススペースに関する情報 ジャーナル取得ファイルを追加した場合に表示されます。 ジャーナル取得ファイルのデータベーススペースに関する情報は以下が表示されます。 ・データベーススペース名(ファイルサイズ) ・ローデバイス名 ・ファイル名
例4.文字コードに関する情報を表示する
------------------------------------------------ tjnlstat -c ------------------------------------------------
CharacterCode Environment ---------------------------------------------------------- OS code : EUC SymfoWARE/RDB Database code : UNICODE |
CharacterCode Environment ---------------------------------------------------------- SymfoWARE/RDB Database code : UNICODE |
表示内容の説明
CharacterCode Environment : 文字コードに関する情報 OS code : OSの文字コード OSの文字コードは以下が表示されます。 ・EUC ・SJIS ・UNICODE SymfoWARE/RDB Database code : Symfoware/RDBのデータベースの設定文字コード Symfoware/RDBのデータベースの設定文字コードは以下が表示されます。 ・EUC ・UTF8 ・SJIS ・UNICODE
機能
取得定義を登録するコマンドです。以下の操作を行います。
取得定義の追加
取得定義の変更
取得定義の削除
登録された取得定義および定義反映を行った後に修正されていない取得定義を新取得定義と呼びます。新取得定義は定義反映を行うことによって、有効な定義となります。定義反映が行われた定義を、現取得定義と呼びます。
入力形式
-------------------------------------------------------------------------- tjnlfmtdef [ -s sysname ] { -a | -m | -d } { -f filename | -i } --------------------------------------------------------------------------
パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義操作を指定します。
-a : 指定された定義内容を新規に追加する
-m : 指定された定義内容で既存の定義を変更する
-d : 指定された取得定義ファイルに記述されている取得定義を削除する
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、取得定義ファイルを作成しておく必要があります。作成方法については、"11.4.4.1 取得定義の作成"を参照してください。
TJNLの環境を削除した場合、登録されていた定義はすべて削除されます。
定義操作は取得定義単位に行われます。取得定義ファイル内に複数の取得定義を記述している場合、一部の取得定義で異常が発生してもコマンドの実行は継続され、取得定義ファイルに記述されたすべての取得定義に対して定義操作が行われます。
定義内容を標準入力から入力する指定をした場合は、EOF(End of File:ファイルの終端)となるまで読込みが続けられます。通常の設定であれば、EOF文字はCTRLキー+D(WindowsではCTRLキー+Z)を同時に押すことによって入力できます。
使用例
例.取得定義を追加する
------------------------------------------------ tjnlfmtdef -f fmtdef -a ------------------------------------------------
機能
取得定義を表示するコマンドです。登録されている取得定義の内容を以下の形式で表示します。
一覧形式
定義書式形式
メッセージキューとの関連形式
現取得定義、新取得定義ともに表示できます。また、現取得定義と新取得定義の差分の表示も行えます。現取得定義および新取得定義についての詳細は"11.9.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 : 配付定義との関連を表示する
表示の対象となる取得定義名を指定します。複数の取得定義名を指定する場合は、取得定義名を空白で区切って指定します。
本パラメタを省略した場合は、すべての取得定義が表示の対象となります。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例1.現取得定義の一覧を表示する
-------------------------------------------------------------------------- tjnlprtfmtdef -c --------------------------------------------------------------------------
現取得定義の一覧
Name ----------------------------------------------------------------- e_tokyo E_TOKYO HOKURIKU osaka OSAKA W_TOKYO |
表示内容の説明
Name : 登録済みの取得定義名
例2.現取得定義を定義書式形式で表示する
-------------------------------------------------------------------------- tjnlprtfmtdef -c -d W_TOKYO --------------------------------------------------------------------------
定義書式形式での表示
-- DefName : W_TOKYO -- Update : 2010/12/01 11:22:33 -- User : tjnluser LOGFMT "W_TOKYO" TABLE "家電"."関東地区"."商品マスタ" ( "商品名" : "商品名" CHARACTER(30) , "商品番号" : "商品番号" INTEGER , "商品区分" : "商品区分" NUMERIC(5,0) CONV=(SIGN(OFF)) , "製造元" : "製造元" CHARACTER(500) ) TABLE "家電"."関東地区"."売り上げ管理" ( "単価" : "単価" INTEGER , "売り上げ額" : "売り上げ額" INTEGER ) DSI "家電"."関東地区"."売り上げ管理" "港区DSI" , "荒川区DSI" 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_aichi | QUE_TYUBU |----------------------------------------------------- | QUE_TOKAI ---------------------------------------------------------------------- E_KANAGAWA | QUE_KANAGAWA |----------------------------------------------------- | QUE_KANAGAWA | QUE_KANTO ---------------------------------------------------------------------- E_NIIGATA | QUE_KANTO |------------------------------------------------------ | QUE_JOUETU ---------------------------------------------------------------------- |
表示内容の説明
Name : 取得定義名 current def : 現配付定義で、取得定義と関連付けられているメッセージキュー new def : 新配付定義で、取得定義と関連付けられているメッセージキュー なお、関連付けられているメッセージキューが存在しない場合は、空欄が表示されます。
機能
簡易取得定義から取得定義を生成するコマンドです。
入力形式
---------------------------------------------------------------------------------- tjnlcrtfmtdef [ -s sysname ] -f in_filename { -o out_filename | -p } ----------------------------------------------------------------------------------
パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
取得定義の出力先を指定します。
-o out_filename: 取得定義を指定されたファイルに出力する
-p: 取得定義を標準出力に出力する
注意事項
本コマンドは、Symfoware/RDB連携用のTJNL環境でのみ実行できます。
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、Symfoware/RDBを起動しておく必要があります。Symfoware/RDBに関する詳細は、Symfowareのマニュアルを参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、簡易取得定義ファイルを作成しておく必要があります。作成方法については、"B.7 取得定義の生成"を参照してください。
出力先にファイルを指定し、そのファイルが既に存在する場合、上書きについての問合せが行われます。
簡易取得定義に誤りがあった場合、または、指定された定義がSymfoware/RDBに存在しない場合、取得定義の生成は行いません。
使用例
例.取得定義を生成しファイルに出力する
----------------------------------------------------------- tjnlcrtfmtdef -f simpledef -o fmtdef -----------------------------------------------------------
機能
配付定義を登録するコマンドです。以下の操作を行います。
配付定義の追加
配付定義の変更
配付定義の削除
登録された配付定義および定義反映を行った後に修正されていない配付定義を新配付定義と呼びます。新配付定義は定義反映を行うことによって、有効な定義となります。定義反映が行われた定義を、現配付定義と呼びます。
入力形式
---------------------------------------------------------------------------------- tjnldef [ -s sysname ] { -a | -m | -d } -f filename ----------------------------------------------------------------------------------
パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義操作を指定します。
-a : 指定された定義内容を新規に追加する
-m : 指定された定義内容で既存の定義を変更する
-d : 指定された配付定義ファイルに記述されている配付定義を削除する
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドを実行する前に、配付定義ファイルを作成しておく必要があります。作成方法については、"11.4.5.1 配付定義の作成"を参照してください。
TJNLの環境を削除した場合、登録されていた定義はすべて削除されます。
定義操作は配付定義単位に行われます。配付定義ファイル内に複数の配付定義を記述している場合、一部の配付定義で異常が発生してもコマンドの実行は継続され、配付定義ファイルに記述されたすべての配付定義に対して定義操作が行われます。
使用例
例.配付定義を追加する
------------------------------------------------ tjnldef -a -f putdef ------------------------------------------------
機能
配付定義を表示するコマンドです。登録されている配付定義の内容を以下の形式で表示します。
一覧形式
定義書式形式
現配付定義、新配付定義ともに表示できます。また、現配付定義と新配付定義の差分の表示も行えます。現配付定義および新配付定義についての詳細は"11.9.3.9 tjnldef(配付定義を登録する) "を参照してください。
複数の配付定義が存在する場合は、メッセージキュー名を昇順に並び替えて表示します。
入力形式
-------------------------------------------------------------------------------------------- tjnlprtdef [ -s sysname ] { -c | -n | -m } [ -d ] [ quename-1 [ quename-2 … [ quename-n ] ] ] --------------------------------------------------------------------------------------------
パラメタの説明
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
定義の種別を指定します。
-c : 現配付定義の内容を表示する
-n : 新配付定義の内容を表示する
-m : 現配付定義と新配付定義の差分を表示する
定義書式形式で表示する場合に指定します。本オプションを省略した場合は、配付定義で定義されているメッセージキュー名の一覧を表示します。なお、本オプションは、-cオプション、-nオプションを指定した場合にのみ指定できます。
表示の対象となるメッセージキュー名を指定します。複数のメッセージキュー名を指定する場合は、メッセージキュー名を空白で区切って指定します。
本パラメタを省略した場合は、すべてのメッセージキューが表示の対象となります。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、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 : 2003/04/24 11:22:33 # User : tjnluser [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 : 2003/04/24 11:22:33 # User : tjnluser [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 : 2003/04/24 11:22:33 # User : tjnluser [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"を指定します。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMおよびSymfoware/RDBを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、Symfoware/RDBに関する詳細はSymfowareのマニュアルを参照してください。
TJNLはSymfoware/RDBに対して、ユーザ名“SYSTEM”で接続します。そのため、ジャーナル取得対象のデータベースに対して利用者登録の使用を宣言している場合は、事前にユーザ名“SYSTEM”をOSの認証機構を使用する利用者として登録してください。ユーザの登録に関する詳細はSymfowareのマニュアルを参照してください。
使用例
例.定義を反映してTJNLを起動する
---------------------------------------------- trmqdstrsvc -n TJNL ----------------------------------------------
機能
TJNLを停止するコマンドです。
入力形式
---------------------------------------------- trmqdstpsvc [ -s sysname ] svcname ----------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
サービス名として"tjnl"または"TJNL"を指定します。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドによりTJNLを停止する前に、すべてのアプリケーションプログラムを、Symfoware/RDBから切断しておいてください。
使用例
例.TJNLを停止する
---------------------------------------------- trmqdstpsvc TJNL ----------------------------------------------
機能
TJNLの一部機能であるジャーナル取得機能、ジャーナル配付機能を起動するコマンドです。
入力形式
----------------------------------------------
tjnlstr [ -s sysname ] { -g | -p [ -n ] }
----------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
起動する機能を指定します。
-g : ジャーナル取得機能
-p : ジャーナル配付機能
未反映の配付定義を反映してからジャーナル配付機能を起動する場合に指定します。なお、本オプションは、-pオプションと同時に指定してください。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを使用してジャーナル取得機能またはジャーナル配付機能を起動するには、TJNLが運用中である必要があります。
使用例
例1.ジャーナル取得機能を起動する
---------------------------------------------- tjnlstr -g ----------------------------------------------
例2.ジャーナル配付機能を定義反映モードで起動する
---------------------------------------------- tjnlstr -p -n ----------------------------------------------
機能
TJNLの一部機能であるジャーナル取得機能、ジャーナル配付機能を停止するコマンドです。
入力形式
----------------------------------------------
tjnlstp [ -s sysname ] { -g | -p }
----------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
停止する機能を指定します。
-g : ジャーナル取得機能
-p : ジャーナル配付機能
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドによりジャーナル取得機能を停止する前に、すべてのアプリケーションプログラムを、Symfoware/RDBから切断しておいてください。
使用例
例1.ジャーナル取得機能を停止する
---------------------------------------------- tjnlstp -g ----------------------------------------------
例2.ジャーナル配付機能を停止する
---------------------------------------------- tjnlstp -p ----------------------------------------------
機能
ジャーナル・チェックポイントを取得するコマンドです。本コマンドの実行により、ジャーナル・チェックポイントの情報がジャーナル取得ファイルに取得されます。
なお、ジャーナル・チェックポイントはジャーナル配付機能が運用状態のときにメッセージキューへ配付されます。ジャーナル・チェックポイントが配付された時点で、配付された旨を通知するメッセージをコンソールに出力します。
入力形式
---------------------------------------------- tjnlckpt [ -s sysname ] -k ckptname ----------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
業務の区切りとして取得するジャーナル・チェックポイントの名前を、32byte以内の文字列で指定します。使用可能な文字は、英数字、"@"、"_"です。なお、本コマンドを実行する前に、取得定義によりジャーナル・チェックポイント名を定義しておく必要があります。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRM、Symfoware/RDB、TJNLおよびジャーナル取得機能を起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を、Symfoware/RDBに関する詳細はSymfowareのマニュアルを参照してください。また、TJNLの起動は"11.9.3.11 trmqdstrsvc(TJNLを起動する)"を、ジャーナル取得機能の起動は"11.9.3.13 tjnlstr(TJNLの一部の機能を起動する)"を参照してください。
配付定義のOutCodeキーワードにGS_KANAを指定した場合は、ジャーナル・チェックポイントの名前には英小文字を使用しないでください。
使用例
例.ジャーナル・チェックポイント"JNL_END"を取得する
---------------------------------------------- tjnlckpt -k JNL_END ----------------------------------------------
機能
利用ジャーナルをメッセージキューより取り出し、一般ファイルに格納するコマンドです。
メッセージ取出し途中にシステムダウンなどの異常が発生した場合に備えて、データを一時的に以下の名前のファイルに格納します。
{指定されたファイル名}.{TRMシステム名}MQDMQD |
コマンドが1回の操作で取り出すデータを取り出し終えた時点で、指定されたファイル名に変更します。
入力形式
------------------------------------------------------------- tjnlgetmsg [ -s sysname ] -f filename [ -j ] qname -------------------------------------------------------------
パラメタ
TRMシステム名を指定します。本パラメタを省略した場合、TRMシステム名は"TRM001"となります。
利用ジャーナルを格納するファイル名を指定します。
ファイルを上書きするかの問合せを回避する場合に指定します。
利用ジャーナルを取り出すメッセージキュー名を指定します。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMを起動しておく必要があります。TRMに関する詳細は"第4部 TRM"を参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
本コマンドは、多重で実行できません。
本コマンドではシステム内で取得した利用ジャーナルのメッセージのみ扱えます。JournalTransferを使用して転送された利用ジャーナルのメッセージは扱えません。
1つのメッセージキューに対して、本コマンドの実行と以下の処理を同時に行わないでください。利用ジャーナルが正しく取り出せないことがあります。
JournalTransferによるメッセージの送信
TRMのコマンドによるメッセージの削除
作成されるファイルのアクセス権は、コマンド実行者が新規に作成したファイルのアクセス権になります。
本コマンドの実行中にシステムダウンなどの異常が発生した場合は、以下の点に注意してください。
指定したファイル名のファイルが作成されていない場合は、メッセージ取出しが完了していません。再度本コマンドを実行してください。
指定されたファイル名のファイルが作成されている場合でも、取り出したメッセージがメッセージキューから削除されていないことがあるため、別の名前を指定して本コマンドを実行した後、前回の実行時に作成されたファイルとデータの内容を比較してください。
今回の実行時に作成されたファイルに、前回の実行時に作成されたファイルと同じ内容のデータが含まれる場合には、今回の実行時に作成されたファイルを使用し、前回の実行時に作成されたファイルは破棄してください。
上記以外の場合は、両方のファイルを使用してください。
使用例
例.メッセージキュー"QUE001"より利用ジャーナルを取り出す
---------------------------------------------- tjnlgetmsg -f outfile QUE001 ----------------------------------------------
メッセージ取出しコマンドの表示例
first data time : 2003/04/09 15:35:28 last data time : 2003/04/09 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 : ジャーナル配付完了通知の予約が行われている場合、その予約を取消します。
注意事項
本コマンドは、スーパユーザ(WindowsではAdministratorsローカルグループのユーザ)およびTRM利用者グループのユーザ(Windows 2003のみ)が実行できます。権限の詳細は、"17.1.3 TRM利用者グループの作成"を参照してください。
本コマンドを実行する前に、TRMおよびSymfoware/RDBを起動しておく必要があります。TRMの起動に関する詳細は"第4部 TRM"を、Symfoware/RDBの起動に関する詳細は、Symfowareのマニュアルを参照してください。
TJNLの運用状態に関連なく、本コマンドを実行できます。
使用例
例1.ジャーナル取得ファイルに未配付のジャーナルが存在するか否かを通知する
------------------------------------------------------------- tjnlinfle -------------------------------------------------------------
例2.ジャーナル配付完了通知を予約する
------------------------------------------------------------- tjnlinfle -w -------------------------------------------------------------
例3.ジャーナル配付完了通知の予約を取り消す
------------------------------------------------------------- tjnlinfle -p -------------------------------------------------------------